Rechercher un article
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>