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

API.addSubscriber

This action allows you to add a subscriber to one of your publications

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.
subscription_code Use the API code supplied in the “Your subcriptions” page, or recovered by the getAccountSubscriptions API
subscriber Table that describes the subscriber and contains the following elements (the order is of no importance):
  • Login: Login of the subscriber
  • FirstName: First name of the subscriber
  • LastName: Last name of the subscriber
  • Email: Email address of the subscriber
  • IsActive: Status of the subscriber: 1 (active) or 0 (inactive).
  • Extras: VARCHAR field of up to 255 freely usable characters
  • Language (optional): Language of the subscriber, using a two-letter code. If left blank, the language of your account will be used.

Response

This request sends the character string “ok” if successful.

An error message is sent back in case of problems.

Example

<!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>Subscriber creation</title>
</head>
<body>
<?php
include_once('nusoap.php');
$client = new soapclient('http://www.calameo.com/api/?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.addSubscriber';
$new_subscriber = array (
'Login'		=> 'login',
'FirstName'		=> 'firstname',
'LastName'		=> 'lastname',
'Email'		=> 'e-mail',
'IsActive'		=> '1',
'Extras'		=> 'Comment of up to 255 characters',
'Language'		=> 'en',
);
$params = array (
'api_key'		=> '123346544abdefbca1546854',
'login'		=> 'email@myaccount.com',
'md5_pwd'		=> 'd4f7ccab36fbfedc5f53e09d20d6973a',
'subscription_code'	=> '05511df55155d5a5bc5',
'subscriber'	=> $new_subscriber,
);
$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>';
echo 'Subscriber successfully created!';
echo '</pre>';
}
}
?>
</body>
</html>