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

API.getBookInfos

This action allows you to recover the information about a publication using its unique key.

Request

api_key Use your API key
login Use the e-mail address of an account profile that has access to the APIs.
md5_pwd Use the password from the profile, encrypted in MD5 format.
book_code Unique identifying key for the publication, supplied in the « Your publications » page

 

Response

This request sends a table with the following information:

Code Unique identifying key for the publication.
Name Title of the publication.
Description Description of the publication.
IsPrivate Sends 1 if the publication is private and 0 if not.
AllowMini Sends 1 if the publication allows access to the miniCalaméo and 0 if not.
Pages Number of pages of the publication.
Width Width of a page of the publication.
Height Height of a page of the publication.
Date Date of citation of the publication.
Creation Date of creation of the publication
Modification Date of the last modification of the publication.
PictureUrl Absolute URL for the publication’s cover
ThumbUrl Absolute URL for the publication’s thumbnail.
PublicUrl Absolute URL for the publication’s overview.
ViewUrl Absolute URL for the publication’s reading page.
CommentsUrl Absolute URL for the publication’s comments.

 

An error message is sent back in case of problems.

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>Publication information</title>
</head>

<body>
<?php

    include_once('nusoap.php');
    
    $client = new soapclient('http://api.calameo.com/?wsdl', true);

    $err = $client->getError();
	
    if ($err) {
       // Displays errors
       echo 'SOAP Error: ' . $err;
       // If an error occurs, no need to continue
       die('An error occurred! !');
    }

    $message = 'API.getBookInfos';

    $params = array (
		    'api_key'		=> '05511df55155d5a5bc5',
		    'login'		=> 'email@myaccount.com',
		    'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
		    'book_code'		=> '05511df551231321'
		    );

    $result = $client->call($message, $params);

    if ($client->fault) {
        // An error occurred
        die('An error occurred !');
    } else {
        // Vérifie si une erreur SOAP n'a pas été renvoyée
        $err = $client->getError();
        if ($err) {
            // Display the error
	    echo 'SOAP Error: ' . $err ;
        } else {
	    // All went well, you can process the result => $result
            echo '<pre>';
            print_r($result);
            echo '</pre>';
        }
    }

?>
</body>
</html>