MinURL : Documentation de l'API

Explication rapide

L'API s'appelle via l'url "http://minu.me/min-api.php", et vous permet de récupérer les statistiques d'un lien via un logiciel ou autre.
Vous devez toujours fournir certains paramètres à cette derniere :

clef : Votre clef d'API ( disponible dans votre compte ) à garder secrète.
format : xml, csv, json, php (via var_export). Si elle n'est pas renseignée, le retour est au format text/plain.

Exemple : http://minu.me/min-api.php?format=json&clef=MACLEFSECRETE

Récupérer les Stats ( Clics )

Paramètres supplémentaires :

mode : stats
url : votre minurl au format alpha_numerique(et tirets)
Valeurs :
- MinURL normale : "aaa" pour http://minu.me/aaa
- MinURL personnalisée : "-aaa" pour http://minu.me/-aaa

Exemple : http://minu.me/min-api.php?clef=MACLEFSECRETE&format=xml&mode=stats&url=aaa

Récupérer le compteur

Vous pouvez récupérer les compteurs ( un nombre ) des liens publics.
Une clef API n'est pas nécessaire pour cette requête.

Exemple : http://minu.me/min-api.php?format=xml&mode=clics&url=aaa

Codes de statut

0 : Ok, aucun souci.
1 : Problème d'authentification : Mauvaise clef d'API ?.
2 : Problème de possession : La ressource demandée ne vous appartient pas.
3 : Problème existentiel : La ressource demandée n'existe pas.
42 : Problème ultime : Vous avez voulu bidouiller sans lire la doc, sauf que bah ... FAIL.

Format CSV et TXT

La première ligne sera le code numérique, sans espace, suivi d'un saut de ligne ( \n ) A partir de la ligne #2 :

txt : format texte séparé par des tabulations ( \t )
csv : format csv séparé par des points-virgules ( ; )

Format PHP, JSON

Le retour est un tableau du type :

statut = code_numerique
valeur = valeur

Le retour JSON supporte le paramètre callback, dont la valeur doit passer via cette REGEX : #^([A-Za-z0-9_-]+)$#

Format XML

Le retour est un fichier du type :

<?xml version="1.0"?>
<root>
	<statut>code_numerique</statut>
	<valeur>valeur</valeur>
</root>

Garanties de l'API

Cette API est fournie sans aucune garantie de service, stabilité, fiabilité, temps de mise en ligne, limitations dans le temps. On vous garantit néanmoins qu'on fera de notre mieux pour la maintenir en bon état