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

API.reviseBooks

Cette action vous permet de publier une nouvelle version d'un ou plusieurs documents de votre souscription

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
documents

Tableau contenant les documents à publier.

Chaque document est un tableau comprenant les éléments suivants (l'ordre n'a pas d'importance) :

Requis:

  • Code : Clé unique d'identification de la publication fournie dans la page « Vos publications »
  • CID : Identifiant du fichier uploadé. Voir l'exemple de code ci-dessous.

Réponse

Cette requête retourne un tableau contenant une ligne par document mis à jour, chaque ligne étant un tableau ayant pour clé le n° du document dans la requête initiale (à partir de 1) et comprenant les éléments suivants

Type "Success" si la mise à jour a eu lieu, "Error" dans le cas contraire
CID Identifiant du fichier uploadé
Message Texte confirmant le succès ou détaillant l'erreur.
Book

En cas d'échec, absent.

En cas de succès, tableau contenant les éléments suivants:

  • Code : Clé unique d'identification de la publication.
  • Name : Titre de la publication.
  • Description : Texte descriptif de la publication.
  • IsPrivate : Retourne 1 si la publication est privée et 0 dans le cas contraire.
  • AllowMini : Retourne 1 si la publication permet l'accès au miniCalaméo et 0 dans le cas contraire
  • Date : Date de référence de 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.
  • ViewUrl : URL absolue de la page de lecture de la publcation.
  • CommentsUrl : URL absolue de la page de commentaires de la publication
ErrorCode Code d'erreur. Vide 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>Màj de publications</title>
</head>
<body>
<?php
include_once('nusoap.php');
include_once('nusoap_mime.php');
$client = new nusoap_client_mime('http://www.calameo.com/api/?wsdl', true);
$client->setHTTPEncoding('gzip, deflate');
$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.updateBook';
$cid1 = $client->addAttachment('', 'c:/mon_premier_document.pdf');
$doc1 = array(
'CID'		=> $cid1,
'Code'          => '0000000006589874562'
);
$cid2 = $client->addAttachment('', 'c:/mon_second_document.pdf');
$doc2 = array(
'CID'		=> $cid2,
'Code'          => '0000000006589874562'
);
$params = array (
'api_key'		=> '123346544abdefbca1546854',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'subscription_code'	=> '05511df55155d5a5bc5',
'documents'	        => array($doc1, $doc2),
);
$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 'documents publiés avec succès!';
echo '</pre>';
}
}
?>
</body>
</html>