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

API.publishFromUrl

Cette action vous permet de publier un ou plusieurs documents (jusqu'à 50) directement depuis internet

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.
subscription_code Utilisez le code API fourni dans la page « Vos souscriptions », ou récupéré par l'API getAccountSubscriptions
documents

Tableau contenant les documents à publier.

Chaque document est un tableau comprenant les éléments suivants (l'ordre n'a pas d'importance) :

Requis:

  • URL : Adresse internet du document à publier

Facultatifs (Les valeurs utilisées par défaut sont soulignées) :

  • CategoryReference : Catégorie de la publication:
     
    • 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 : Format de la publication:
     
    • 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 : Langue de la publication, sous la forme d'un code à 2 lettres ISO-639-1, ou bien inconnu: UNKNOWN
  • Name : Titre de la publication (si vide, le nom de fichier sera utilisé)
  • Description : Description de la publication
  • Date : Date de la publication
  • IsPublished : Activation de la publication (true ou false)
  • PublishingMode : Mode d'accès (public: 1, privé: 2)
  • PrivateUrlMode : Création d'une URL privée (oui: 1 ; non: 0)
  • SubscribingMode : Autoriser l'accès aux abonnés (oui: 1 ; non: 0)
  • CommentingMode : Traitement des commentaires (Aucun commentaire: 0, modérer tout: 1, modérer sauf les contacts: 2, accepter que les contacts: 3, accepter tous: 4)
  • DownloadingMode : Autoriser le téléchargement (Non: 0, que les contacts: 1, oui: 2)
  • MiniMode : Autoriser la création du MiniCalaméo (oui: 1 ; non: 0)
  • AdultMode : Publication réservée aux adultes (oui: 1 ; non: 0)
  • ReadingMode : Sens de lecture (De gauche à droite: 0, de droite à gauche: 1)
  • LicensingMode : Licence (aucune: laisser vide ; pd (domaine public) ; Creative commonsby / by_nc / by_nc_nd / by_nc_sa / by_nd / by_sa)
  • LogoUrl : Url du logo personnalisé
  • LogoLink : Lien du logo personnalisé
  • BackgroundUrl : Url de l'arrière-plan personnalisé
  • MusicUrl : Url de l'ambiance sonore personnalisée
  • MusicMode : Mode de l'ambiance sonore (en boucle: 0, une fois:1)
  • SoundEffectMode : Jouer les effets sonores (oui: 1 ; non: 0)
  • FlipSoundUrl : Url d'un effet sonore de changement de page personnalisé

Réponse

Cette requête retourne un tableau contenant une ligne par document publié, chaque ligne étant un tableau ayant pour clé le n° du document dans la requête initiale (à partir de 1) et comprenant les éléments suivants

Type "Success" si l'ajout a eu lieu, "Error" dans le cas contraire
Message Texte confirmant le succès ou détaillant l'erreur.
Book

En cas d'échec, absent.

En cas de succès, tableau contenant les éléments suivants:

  • Code : Clé unique d'identification de la publication.
  • Name : Titre de la publication.
  • Description : Texte descriptif de la publication.
  • IsPrivate : Retourne 1 si la publication est privée et 0 dans le cas contraire.
  • AllowMini : Retourne 1 si la publication permet l'accès au miniCalaméo et 0 dans le cas contraire
  • Date : Date de référence de publication.
  • Creation : Date de création de la publication.
  • Modification : Date de la dernière modification de la publication.
  • PublicUrl : URL absolue de la page de présentation de la publication.
  • ViewUrl : URL absolue de la page de lecture de la publcation.
  • CommentsUrl : URL absolue de la page de commentaires de la publication
ErrorCode Code d'erreur. Vide en cas de succès.

 Un message d'erreur est retourné en cas de problème.

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 de documents</title>
</head>
<body>
<?php
include_once('nusoap.php');
$client = new nusoap_client('http://www.calameo.com/api/?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.publishFromUrl';
$doc1 = array(
'URL'		=> 'http://www.mon-site.com/mon-fichier.pdf',
'Name'		=> 'Mon premier document',
'Description'	=> 'Ceci est un premier document',
'Date'		=> '2007-12-24',
'IsPublished'	=> true,
'PublishingMode'=> 2,
'AdultMode'	=> 1
);
$doc2 = array(
'URL'		=> 'http://www.un-autre-site.com/un-fichier-word.doc',
'Name'		=> 'Mon seconddocument',
'Description'	=> 'Ceci est un premier 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) {
// 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>';
echo 'documents publiés avec succès!';
echo '</pre>';
}
}
?>
</body>
</html>