Obtenir la date de création d'une miniature - API

Obtenir la date de création d'une miniature

L'obtention d'une date de mise à jour d'une miniature repose sur le même système que l'affichage des miniatures.
L'adresse de base est : http://www.apercite.fr/api/date-apercite/

Il faut cependant spécifier d'autres paramètres. Voici la liste des paramètres :

Votre pseudo : C'est le pseudo que vous avez indiqué lors de votre inscription. Il est affiché à côté du bouton de déconnexion en haut à droite de la page.
Votre clé API : C'est la clé API que nous vous avons généré. Vous pouvez mettre à jour la clé à tout moment en vous rendant sur la page Clé API. Cette clé ne doit en aucun cas être librement diffusé.
La taille : La taille de l'apercite sur lequel vous souhaitez obtenir la taille. La taille varie de 80x50 à 800x600. La liste des tailles disponibles est présente sur la page d'accueil.
Javascript (oui / non) : Indique si l'apercite sur lequel vous souhaitez obtenir la date de mise à jour doit avoir Javascript activé ou non.
Java (oui / non) : Indique si l'apercite sur lequel vous souhaitez obtenir la date de mise à jour doit avoir Java activé ou non.
L'adresse : L'adresse pour laquelle vous souhaitez obtenir la date de mise à jour.

Tous les paramètres ci-dessus sont obligatoires ! Voici un exemple : http://www.apercite.fr/api/date-apercite/VotrePseudo/VotreCleAPI/120x90/oui/oui/http://www.apercite.fr/
L'utilisation de cette API nécessite un abonnement à Apercite.

Messages pouvant-être retournée par l'API :
AAAAMMJJHHmmSS	Représente la date de mise à jour de l'apercite. La date est composé de l'année, du mois, du jour, de l'heure, de la minute et de la seconde. Ces éléments sont tous mis les uns à la suite des autres.
00000000000000	L'apercite n'a pas encore été généré.
ERREUR_IDENTIFICATION	Pseudo et / ou clé API incorrect.
ABONNEMENT_EXPIRE	Votre abonnement est expiré. Vous devez le renouveler.
ADRESSE_INVALIDE	L'adresse que vous avez spécifié n'est pas correcte.
ADRESSE_VIDE	Vous n'avez spécifié aucune adresse.
USER_AGENT_INVALIDE	L'User-Agent de votre navigateur est invalide.
DEMANDE_INVALIDE	La demande n'a pas été formulé correctement.

Exemple d'utilisation de l'API avec PHP :

<?php
$result = file_get_contents('http://www.apercite.fr/api/date-apercite/VotrePseudo/VotreCleAPI/120x90/oui/oui/http://www.apercite.fr/');
if($result == '00000000000000') {
echo 'Image en cours de création';
}
elseif(preg_match('#^[0-9]{14}$#', $result)) {
echo 'Image créée le '.$result;
}
else {
/*
Erreur de la demande de la date de création de la miniature.
Vous pouvez vous envoyer un courriel avec le contenu de l'erreur stocké dans $result
Je vous conseille aussi si vous affichez le contenu de l'erreur dans un courriel ou sur une page Internet
d'effectuer : $result = htmlspecialchars($result, ENT_QUOTES);
Ainsi vous évitez toute tentative de hack envers votre service.
//*/
}
?>

En cas de problème d'utilisation de l'API, nous nous tenons à votre disposition pour vous aider dans l'utilisation de celle-ci.

English Version

Partagez :