Développeurs

Retrouvez nos différents outils pour utiliser notre service premium sur vos sites internet ou modules. Vous pouvez retrouver toutes les informations de développement sur le dépot Github.

N'hésitez pas à nous contacter si vous souhaitez de l'aide pour mettre en place notre service.

Premium

Pour utiliser les fonctionnalités premium vous devez générer un hash contenant votre clé API. Cette étape est nécessaire afin de nous permettre de controler les comptes.

La génération du hash nécessite de joindre dans un ordre précis toutes les informations de la vignette. Prenons les informations suivantes :

  1. Type : 3d (thumb, 3d, full)
  2. Url : https://www.easy-thumb.net
  3. Taille : 640x480
  4. Vue : desktop (desktop, tablet, mobile)
  5. Clé Secrète : 123456azerty

Vous devez absolument respecter l'ordre suivant : Clé, Taille, Type, Url, Vue et séparer les éléments par un tiret.

La clé serait donc la suivante : 123456azerty-640x480-3d-https://www.easy-thumb.net-desktop. Il faut ensuite générer un hash sha1 de cette chaîne.

Pour les thumbs full, vous devez spécifier que la largeur. Pour l'exemple vous ne devriez utiliser que 640.

Vous pouvez retrouvez une classe PHP ainsi que quelques exemples sur notre dépôt Github.

Vignettes personnalisées

Cette option premium vous permet simplement d'afficher votre propre image le temps de la génération d'une miniature ou lors d'une erreur. Voici un exemple :

https://www.easy-thumb.net/thumb?url=http://www.google.fr&wait=http://www.example.org/example.jpg&error=http://www.example.org/error.jpg

L'image personnalisée est utilisée sans aucune modifications. Si vous souhaitez adapter la taille des images par rapport à la miniature, vous devez transmettre une image d'une résolution identique.

Headers informatifs

Afin de vous tenir informé du statut des miniatures, nous vous transférons des headers http. Voici la liste :

Voici un exemple de code PHP afin de les traiter :

Générateur de hash

Ce générateur vous permet de tester la génération des hashs de vos outils. Renseignez les différentes informations désirées et vérifier la clé générée.