Mettre à jour une miniature - API

La 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/maj-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ée.
Le type (adresse / domaine / sous-domaines) : Indique s'il faut mettre à jour uniquement une adresse, toutes les miniatures d'un domaine ou toutes les miniatures des sous-domaines.
Javascript (tout / oui / non) : Indique s'il faut mettre à jour les miniatures qui ont ou pas le Javascript d'activé.
Java (tout / oui / non) : Indique s'il faut mettre à jour les miniatures qui ont ou pas le Java d'activé.
L'adresse : Pour finir, vous devez indiquer l'adresse du site que vous souhaitez aperciter.

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

Messages pouvant-être retournée par l'API :
ACCEPTE	Votre demande a correctement été traitée.
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ée 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ée correctement.

Exemple d'utilisation de l'API avec PHP :

<?php
$result = file_get_contents('http://www.apercite.fr/api/maj-apercite/VotrePseudo/VotreCleAPI/adresse/oui/oui/http://www.apercite.fr/');
if($result == 'ACCEPTE') {
echo 'Mise à jour commandée';
}
else {
/*
Erreur de la mise à jour 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 :