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

API.addSubscriber

Cette action vous permet d'ajouter un abonné à une de vos publications

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
subscriber

Tableau décrivant l'abonné et contenant les éléments suivants (l'ordre n'a pas d'importance) :

  • Login : Identifiant de l'abonné
  • FirstName : Prénom de l'abonné
  • LastName : Nom de l'abonné
  • Password  : Mot de passe de l'abonné
  • Email : Adresse e-mail de l'abonné
  • IsActive : Statut de l'abonné: 1 (actif) ou 0 (inactif).
  • Extras : Champ VARCHAR de 255 caractères librement utilisable
  • Language (facultatif) : Langue de l'abonné sous la forme d'un code à deux lettres. Si non renseigné, la langue de votre compte sera utilisée.

Réponse

Cette requête retourne la chaîne de caractères "ok" en cas de succès.

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

Exemple

<!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>Création d'abonné</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.addSubscriber';
$new_subscriber = array (
'Login'		=> 'identifiant_du_nouvel_abonné',		    
'FirstName'		=> 'son_prénom',	    
'LastName'		=> 'son_nom',
'Password'		=> 'son_mot_de_passe',	                      
'Email'		=> 'son_e-mail',
'IsActive'		=> '1',
'Extras'		=> 'Commentaire de 255 caractères maximum',
'Language'		=> 'fr',
);
$params = array (
'api_key'		=> '123346544abdefbca1546854',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'subscription_code'	=> '05511df55155d5a5bc5',
'subscriber'	=> $new_subscriber,
);
$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>';
echo 'Abonné créé avec succès!';
echo '</pre>';
}
}
?>
</body>
</html>