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

API.fetchBookComments

This action allows you to recover the comments of 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 
order (Optional) String of characters used to define the organization criteria of the comments. The possible values are:
  • Date : Date of the comment
way (Optional) String of characters used to define the sort order. The possible values are:
  • UP : Sort by ascending order
  • DOWN : Sort by descending order
start (Optional) Start position of the range of comments sent.
step (Optional) Number of comments to be sent from the start position.

 

Response

This request sends a table with the following information:

PosterID Login of the comment poster.
PosterName Name of the comment poster.
PosterPublicUrl Absolute URL for the comment poster’s page.
PosterThumbUrl Absolute URL for the comment poster’s thumbnail.
Date Date of the comment.
Text Text of the comment.

 

 

An error message is sent back in case of problems.

Example

This example shows how to recover the last 10 comments of a 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>The comments about my publication</title>
</head>

<body>
<?php

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

    $err = $client->getError();
	
    if ($err) {
       // Display the errors
       echo 'SOAP Error: ' . $err;
       // If an error occurs, it\’s useless to continue
       die('An error has occurred!');
    }

    $message = 'API.fetchBookComments';

    $params = array (
		    'api_key'		=> '05511df55155d5a5bc5',
		    'login'		=> 'email@myaccount.com',
		    'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
		    'book_code'		=> '05511df551231321'
		    'order'		=> 'Date',
		    'way'		=> 'DOWN',
		    'start'		=> 0,
		    'step'		=> 10
		    );

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

    if ($client->fault) {
        // An error has occurred
        die('An error has occurred!');
    } else {
        // Verify if a SOAP error wasn’t sent back
        $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>