API.updateBooks

Esta acción le permite actualizar uno o varios documentos.

Solicitud

api_key Usar su clave de API
login Usar la dirección de correo electrónico del perfil de una cuenta que tiene acceso a las APIs.
md5_pwd Usar la contraseña del perfil, codificada en formato MD5.
subscription_code

Usar el código API proporcionado en la página « Sus suscripciones », o recuperado por la API getAccountSubscriptions

documents

 

Tabla con los documentos a publicar.

Cada documento en sí es una tabla que contiene los elementos siguientes (el orden no es importante):
Necesario:

  • CID : Id del archivo cargado. Ver código de ejemplo

Opcional: (Los valores predeterminados están subrayados):

  • CategoryReference : Categoría de la publicación
     
    • Divers: MISC
    • Actualités: NEWS
    • Arts & Design: ARTS
    • Automobiles: AUTO
    • Business: BUSINESS
    • Cinéma: MOVIES
    • Culture: CULTURE
    • Éducation: SCHOOL
    • Voyages: TRAVEL
    • Humour: HUMOR
    • Jeux vidéos: VIDEOGAMES
    • Juridique: LAW
    • Littérature: LITERATURE
    • Musique: MUSIC
    • Nature: NATURE
    • Politique: POLITICS
    • Religion: RELIGION
    • Santé: HEALTH
    • Sciences: SCIENCES
    • Sexy: SEXY
    • Société: PEOPLE
    • Sports: SPORTS
    • Technologie: TECH

 

  • FormatReference : Formato de la publicación
     
    • Divers: MISC
    • Albums: ALBUMS
    • B.D. : BD
    • Brochures: BROCHURES
    • Catalogues: CATALOGS
    • Comics: COMICS
    • Journaux: NEWSPAPERS
    • Livres: BOOKS
    • Magazines: MAGAZINES
    • Mangas: MANGAS
    • Manuels: MANUALS
    • Multimédia: MULTIMEDIA
    • Partitions: SHEETMUSIC
    • Présentations: PRESENTATIONS
    • Rapports: REPORTS
    • Romans: NOVELS

  • DialectReference : Idioma de la publicacion, código ISO- 639-1 de 2 letras para el idioma de publicación, o DESCONOCIDO
  • Name : Título de la publicación (si está vacío se usará “filename” como nombre)
  • Description : Description de la publication
  • Date : Fecha de la publicación
  • IsPublished : Estado de activación (verdadero o falso)
  • PublishingMode : Modo de acceso (público: 1, privado: 2)
  • PrivateUrlMode : Crear una URL privada (sí: 1 ; no: 0)
  • SubscribingMode : Permite el acceso de los suscriptores (sí: 1 ; no: 0)
  • CommentingMode :Comportamiento de los comentarios (Ninguno: 0, moderar todos: 1, moderar excepto contactos: 2, aceptar sólo de los contactos: 3, aceptar todos: 4)
  • DownloadingMode : Modo de descarga (No: 0, sólo contactos: 1, sí: 2)
  • MiniMode : Permite la MiniCalaméo (sí: 1 ; no: 0)
  • AdultMode :Contenido de adultos (sí: 1 ; no: 0)
  • ReadingMode : Modo de lectura (De izquierda a derecha: 0, de derecha a izquierda: 1)
  • LicensingMode : Licencia (ninguna: dejar vacío ; pd (dominio público) ; Creative commons   by / by_nc / by_nc_nd / by_nc_sa / by_nd / by_sa)
  • LogoUrl : URL del logotipo personalizado
  • LogoLink : Enlace del logotipo personalizado
  • BackgroundUrl : URL del fondo personalizado
  • MusicUrl : URL de la música de fondo personalizada
  • MusicMode : Modo de música de fondo (cíclico: 0, reproducir una vez:1)
  • SoundEffectMode : JModos de efectos de sonido (sí: 1 ; no: 0)
  • FlipSoundUrl : URL del sonido de paso de página personalizado
     

Respuesta

Esta solicitud devuelve un conjunto con una línea por documento publicado, cuya clave es un contador que comienza a partir de 1. Cada línea es un conjunto con la información siguiente:

Type “Éxito” o “Error”
CID Id. del archivo.
Message Texte confirmant le succès ou détaillant l'erreur.
Book

En caso de fallo, no presente.

En caso de éxito, conjunto con los siguientes elementos:

  • Code : Clave de identificación única para la publicación.
  • Name : Título de la publicación.
  • Description :  Descripción de la publicación.
  • IsPrivate :  Envía 1 si la publicación es privada y 0 si no lo es.
  • AllowMini : Envía 1 si la publicación permite el acceso a la miniCalaméo y 0 si no.
  • Date : Fecha de cita de la publicación.
  • Creation :  Fecha de creación de la publicación.
  • Modification : Fecha de la última modificación de la publicación.
  • PublicUrl : URL absoluta para la información general de la publicación.
  • ViewUrl : URL absoluta para la página de lectura de la publicación.
  • CommentsUrl : URL absoluta para los comentarios de la publicación.
ErrorCode Código de error. Vacío en caso de éxito

Se devuelve un mensaje de error en caso de problemas.

Ejemplo

<!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>Publish documents</title>
</head>

<body>
<?php

include_once('nusoap.php');
include_once('nusoap_mime.php');

$client = new nusoap_client_mime('http://api.calameo.com/?wsdl', true);

$client->setHTTPEncoding('gzip, deflate');

$err = $client->getError();

if ($err) {
// Mostrar los errores
echo 'SOAP Error: ' . $err;
// Si ocurre un error, es inútil continuar
die('¡Ha ocurrido un error!');
}
$message = 'API.updateBooks';

$cid1 = $client->addAttachment('', 'c:/my_first_document.pdf');

$doc1 = array(
'Code' => '03135743116735424',
'CID' => $cid1,
'Name' => 'My first document',
'Description' => 'This is the first document',
'Date' => '2007-12-24',
'IsPublished' => true,
'PublishingMode'=> 2,
'AdultMode' => 1
);

// Ningún archivo revisado para este documento
$doc2 = array(
'Code' => '2134167313467431',
'Name' => 'My second document',
'Description' => 'This is the second document',
'Date' => '2004-12-24',
'IsPublished' => false,
'PublishingMode'=> 1
);

$params = array (
'api_key' => '123346544abdefbca1546854',
'login' => 'email@moncompte.com',
'md5_pwd' => 'd4f7ccab36fbfedc5f53e09d20d6973a',
'subscription_code' => '05511df55155d5a5bc5',
'documents' => array($doc1, $doc2),
);

$result = $client->call($message, $params);
if ($client->fault) {
// Ha ocurrido un error
die('¡Ha ocurrido un error!');
} else {
// Verifique si no se ha devuelto un error SOAP
$err = $client->getError();
if ($err) {
// Mostrar el error
echo 'SOAP Error: ' . $err ;
} else {
// Proceso satisfactorio, puede procesar el resultado => $result
echo '<pre>';
echo 'Books successfully updated!';
echo '</pre>';
}
}

?>
</body>
</html>

 

 

Customer service discussions
Loading...