API screenshot page web gratuite

Qu’est ce que c’est !

Déjà on va commencer par le commencement, c’est mieux ! Qu’est-ce qu’une API (ou web service en français ou plutôt franglais) ? Il s’agit simplement d’un service en ligne proposant une interface et des méthodes simplifiés de programmation pour utiliser un applicatif ou un service tiers.
Le but ici est de vous permettre de faire des captures d’écran automatiques de site web (Screenshot API) et de les réutiliser dans vos propres applications, et tout ceci gratuitement, il faut seulement créer un compte.

Pourquoi proposer ce service, gratuitement ?

En fait l’idée de créer ce service m’est apparu comme une nécessité lorsque j’ai décidé de créé le plugin d’annuaire web pour wordpress.
Pour moi chaque fiche de site internet devrait être illustrée par une capture d’écran du site présenté.
Il était évident que cette fonctionnalité devait être automatique (hors de question de vous demander d’user la touche « print » de votre clavier).
J’avais donc deux solutions, soit utiliser un service existant, souvent payant, ou si gratuit très fortement limité. En proposant cette solution j’aurai rapidement eu l’impression de ne pas fournir un service complet.
C’est donc pourquoi j’ai décidé de me lancer dans la création de ma propre API.
Si elle devait donc à l’origine n’être créée que pour les besoins du plugin, il n’y avait pas de raison e la restreindre alors autant la proposer aussi à ceux qui souhaiteraient en faire un usage plus élargis.

Comment m’inscrire ?

C’est facile, il suffit de créer un compte. Une fois le compte créer il suffit alors de cliquer sur « obternir une clef d’api ». Alors la magie peut commencer.

— INSERER IMAGE BOUTON —

Comment est-ce que ça fonctionne ?

Il s’agit d’une simple service HTTP, ou plutôt HTTPS dans notre cas. L’url d’appel de l’API se présente de cette façon :

http://www.zvoon.net/api/?api=&url=http://www.mon-site.fr

Il suffit donc de renseigner toutes les informations demandées ci-dessus. Et d’appeler ensuite l’url directement depuis votre navigateur, ou d’émuler la requête HTTP (via CURL, PHP, etc…).
Vous trouverez des exemples concrets d’utilisation sur votre compte.

L’interface ?

L’interface d’administration est relativement simple. Votre clef d’API est affichée tout en haut de la page mon compte, un petit tableau d’aide vous rappel ensuite l’utilisation de l’API et enfin un graphique vous informe de l’utilisation de l’API sur les 7 derniers jour, vous permettant ainsi de savoir où vous en êtes. Pour rappel la limite journalière est fixée à 200 appel.
— Insérer graphique —
Enfin l’API retourne l’image lorsque tout se passe bien, sinon le retour se fera au format JSON avec une erreur explicite. Les erreurs courantes peuvent être l’utilisation d’une clef non autorisée, un quota journalier atteint ou une url de site web non accessible.

Besoin d’aide ?

Une FAQ a été éditée dans le but de répondre aux questions les plus fréquentes.
Si vraiment vous êtes bloqué ou si jamais vous rencontrez un bug je vous invite à me contacter en utilisant le formulaire suivant.

Votre avis / vos suggestions

Il s’agit ici de la toute première version de cette API, si vous avez des idées pour faire évoluer ce service, n’hésitez pas à me faire part de vos idées en utilisant ce formulaire.