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

API.fetchBookComments

Cette action vous permet de récupérer les commentaires d'une publication à partir de sa clé unique.

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.
book_code Clé unique d'identification de la publication fournie dans la page « Vos publications »
order (facultatif) Chaîne de caractères utilisée pour définir le critère de classement des commentaires. Les valeurs possibles sont  :
  • Date : Date du commentaire
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 commentaires retournée.
step (facultatif) Nombre de commentaires à retourner à partir de la position de départ.

 

Réponse

Cette requête retourne un tableau contenant les informations suivantes :

PosterID Identifiant du commentateur.
PosterName Nom du commentateur.
PosterPublicUrl URL absolur de la page du commentateur.
PosterThumbUrl URL absolue de la miniature du commentateur.
Date Date du commentaire.
Text Texte du commentaire.

 

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

Exemple

Cet exemple montre comment récupérer les 10 derniers commentaires d'une publication :

<!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>Les commentaires de ma publication</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.fetchBookComments';
$params = array (
'api_key'		=> '05511df55155d5a5bc5',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'book_code'		=> '05511df551231321'
'order'		=> 'Date',
'way'		=> 'DOWN',
'start'		=> 0,
'step'		=> 10
);
$result = $client->call($message, $params);
$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>