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

API.fetchSubscriptionSubscribers

Cette action vous permet de récupérer tout ou partie des abonnés d'une souscription de votre 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.
subscription_code Utilisez le code API fourni dans la page « Vos souscriptions », ou récupéré par l'API getAccountSubscriptions
order (facultatif) Chaîne de caractères utilisée pour définir le critère de classement des abonnés. Les valeurs possibles sont  :
  • FirstName : Prénom de l'abonné
  • LastName : Nom de l'abonné
  • Login : Identifiant de l'abonné
  • LastLogin : Date de dernière connexion
  • Creation : Date de création de l'abonné
  • Modification : Date de modification de l'abonné
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 d'abonnés retournée.
step (facultatif) Nombre d'abonnés à retourner à partir de la position de départ.

Réponse

Cette requête retourne un tableau contenant les abonnés demandés avec les informations suivantes :

LastName Nom de l'abonné.
FirstName Prénom de l'abonne.
Email Adresse e-mail de l'abonné.
Login Identifiant de l'abonné.
Password Mot de passe de l'abonné.
IsActive Statut de l'abonné: 1 s'il est activé, 0 sans le cas contraire.
Extras Informations complémentaires sur l'abonné, au format varchar de taille 255 caractères
LastLogin Date de dernière connexion.
Creation Date de création de l'abonné.
Modification Date de la dernière modification de l'abonné.

 

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

Exemple

Cet exemple montre comment récupérer les 10 derniers abonnés d'une souscription:

<!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 abonnés les plus récents</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.fetchSubscriptionSubscribers';
$params = array (
'api_key'		=> '123346544abdefbca1546854',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'subscription_code'	=> '05511df55155d5a5bc5',
'order'		=> 'Creation',
'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 '<pre>';
print_r($result);
echo '</pre>';
}
}
?>
</body>
</html>