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://api.calameo.com/?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>

 

Customer service discussions
Loading...
Favicon Get Satisfaction support network