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

API.fetchBookTocs

Cette action vous permet de récupérer la table des matières 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 entrées de la table des matières. Les valeurs possibles sont  :
  • Order : Ordre des pages
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'entrées retournée.
step (facultatif) Nombre d'entrées à retourner à partir de la position de départ.

 

Réponse

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

Name Libellé de l'entrée de table des matières
Level Niveau de l'entrée, à partir de 1 pour le plus élevé.
PageNumber Numéro de la page référencée.

 

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

Exemple

Cet exemple montre comment récupérer les 10 premières entrée de la table des matières 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>La table des matières 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.fetchBookTocs';
$params = array (
'api_key'		=> '05511df55155d5a5bc5',
'login'		=> 'email@moncompte.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'book_code'		=> '05511df551231321'
'order'		=> 'Order',
'way'		=> 'UP',
'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>