English Français Español
ex. : internet calameo download

API.fetchAccountSubscriptions

Cette action vous permet de récupérer tout ou partie des souscriptions d'un compte.

Demande

api_key Utilisez votre clef API
login Utilisez l'adresse e-mail d'un profil du compte ayant accès aux API.
md5_pwd Utilisez le mot de passe du profil encrypté au format MD5.
account_id (facultatif)

Id du compte dont vous souhaitez récupérer les souscriptions.
Si laissé vide, votre compte sera utilisé.
order (facultatif) Chaîne de caractères utilisée pour définir le critère de classement des souscriptions. Les valeurs possibles sont  :
  • Name : Nom de la souscription
  • IsPrimary : Statut de publication principale du compte
  • Modification : Date de modification de la souscription
way (facultatif) Chaîne de caractères utilisée pour définir le sens du classement. Les valeurs possibles sont :
  • UP : Trier par ordre croissant
  • DOWN : Trier par ordre décroissant
start (facultatif) Position de départ de la plage de souscriptions retournée.
step (facultatif) Nombre de souscriptions à retourner à partir de la position de départ.

Réponse

Cette requête retourne un tableau contenant les souscriptions demandées avec les informations suivantes :

Code Clé unique d'identification de la publication.
Name Titre de la publication.
Description Texte descriptif de la publication.
Creation Date de création de la publication.
Modification Date de la dernière modification de la publication.
PublicUrl URL absolue de la page de présentation de la publication.

 

Un message d'erreur est retourné en cas de problème.

Exemple

Cet exemple montre comment récupérer les 10 publications les plus lues d'un compte:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Mes publications les plus lues</title>
</head>
<body>
<?php
include_once('nusoap.php');
$client = new soapclient('http://www.calameo.com/api/?wsdl', true);
$err = $client->getError();
if ($err) {
// Affiche les erreurs
echo 'SOAP Error: ' . $err;
// Si une erreur se produit, il est donc inutile de continuer
die('Une erreur est survenue !');
}
$message = 'API.fetchAccountSubscriptions';
$params = array (
'api_key'		=> '123346544abdefbca1546854',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'account_id'	=> '98765',
'order'		=> 'Name',
'way'		=> 'DOWN',
'start'		=> 0,
'step'		=> 10
);
$result = $client->call($message, $params);
if ($client->fault) {
// Une erreur est survenue
die('Une erreur est survenue !');
} else {
// Vérifie si une erreur SOAP n'a pas été renvoyée
$err = $client->getError();
if ($err) {
// Affiche l'erreur
echo 'SOAP Error: ' . $err ;
} else {
// Tout s'est bien passé, vous pouvez traiter le résultat => $result
echo '<ol>';
foreach ( $result as $book ) {
echo '<li>';
echo '<a href="' . $book['PublicUrl'] . '">';
echo $book['Name'];
echo '</a>';
echo '</li>';
}
echo '</ol>';
}
}
?>
</body>
</html>