Deblan blog

Le cut d'url de Deblan a son API

J'ai développé aujourd'hui l'API de mon service qui raccourcis les URL.

L'API est disponible à cette URL : http://url.deblan.fr/gestion/api.php

Tout ce fait via des requêtes HTTP avec des paramètres passés en GET. Voici la liste des paramètres :
  • url (requis) : adresse web à raccourcir
  • title : titre à insérer dans le lien
  • type : type de redirection (1 pour http, 2 pour une redirection par meta html)
  • time : si type=2, alors time correspond au nombre de secondes avant la redirection (3, 5, 10 autorisés)
  • format : format de retour des informations (json, xml, text autorisés)

Si vous demandez le format json, la valeur de retour est un objet. Il contient :

  • error : attribut (int) qui prendra 0 si aucune erreur n'est détectée sinon 1
  • values : attribut (array) qui contient soit l'url, soit l'ensemble des erreurs

Si c'est spécifiez xml, vous aurez un noeud "response" qui contient :

  • un noeud error : entier qui prendra 0 si aucune erreur n'est détectée sinon 1
  • un noeud values qui contient un ou plusieurs noeuds value qui seront soit l'url générée, soit l'ensemble des erreurs

Par contre, si vous indiquez un format text :

  • Si le retour contient une ligne alors ça sera l'url
  • Si le retour est composée de plusieurs lignes, alors la première contient "error" et les autres contiendront les erreurs
Exemple :

Requête :

http://url.deblan.fr/gestion/api.php?url=https://www.deblan.io/&title=Mon%20blog&format=xml&type=2&time=5

Réponse :

<response>
  <error>0</error>
  <values>
    <value>http://url.deblan.fr/11527/Mon-blog</value>
  </values>
</response>

  • Simon
    • ,
    • Une fois qu'elle sera terminée et propre ;)

Ajouter un commentaire

Vous pouvez utiliser du markdown.Afficher l'aide.