API
Prérequis
Cette clé est une clé publique est limité a 500 utilisations par jours, s'il vous avez besoin d'utiliser cette API pour de gros projets, merci de vous créer un compte.
Via ce compte vous pourrrez aussi modifier et voir le nombre d'URL qui ont été créer via votre application, de nombreuseus autre options sonts disponible.
Clé publique
La clé publique est :
1GJ15dKbhwSW6VI3cFTigjBRkgxQ8EPtPQSU4AS3FTVc80MsiwlPucWQd9NDgbUL
Adresse
Pour les développeurs, Réductible a préparé une API laquelle retourne une réponse aux formats JSON.
Tout ce que vous avez à faire est d'envoyer une requête GET avec votre clé d'API et de l'URL
http://api.reductible.fr/?key=1GJ15dKbhwSW6VI3cFTigjBRkgxQ8EPtPQSU4AS3FTVc80MsiwlPucWQd9NDgbUL&url=votreurl.fr
NB: Pensez à utiliser urlencode($url) afin de ne pas créer d'erreurs lors de l'envoi de votre url.
Variables
| Variables | Valeur | Description | Défaut | Erreur |
| $url= | votre choix | Requis. Permet de définir une adresse de destination pour votre lien. | --- | ER001 & ER002 & ER003 |
| $key= | votre clé | Requis. Permet de définir quel utilisateur utilise l'API. | --- | ER004 & ER005 & ER006 |
| $ndd= | arl ou kurl | Permet de modifier le nom de domaine de destination de votre lien. | arl | ER011 |
| $alias= | votre choix | Permet de modifier l'alias de votre lien. | valeur aléatoire | ER007 & ER008 & ER009 |
| $stats= | oui ou non | Permet d'activer ou non les statistiques. | oui | ER010 |
Utilisation
Pour utiliser le API dans votre application PHP, vous devez envoyer une demande GET via file_get_contents ou cURL. SVP, vérifiez ci-dessous les exemples simples d'utilisation de file_get_contents.
Utilisation de la réponse en JSON.
$url = urlencode('http://votreurl.fr');
$key = '1GJ15dKbhwSW6VI3cFTigjBRkgxQ8EPtPQSU4AS3FTVc80MsiwlPucWQd9NDgbUL';
$apiurl = "http://api.reductible.fr/?url=".$url."&key=".$key;
$result = json_decode(file_get_contents($apiurl),true);
if($result["status"] == 'error') {
echo $result["code"];
} else {
echo $result["url"];
}
Erreurs
Vous pouvez récuperer le code erreur avec $result[""]
| Code | Description |
| ER001 | Votre URL est vide |
| ER002 | Votre URL ne correspond pas à une URL valide (vérifier s'il manque le http ou https) |
| ER003 | Vous tentez de réduire une URL interdit à la réduction (arl.re; kurl.eu; localhost) |
| ER004 | Votre clé est vide |
| ER005 | Votre clé n'est pas une clé valide (Ou n'existe pas) |
| ER006 | Votre clé n'est pas au bon format (a-z0-9A-Z) |
| ER007 | Votre alias est déjà utilisé |
| ER008 | Votre alias est trop long (128 Max.) |
| ER009 | Votre alias n'est pas au bon format (a-z0-9A-Z) |
| ER010 | Votre stat n'est pas valide (différent de oui / non) |
| ER011 | Votre nom de domaine n'est pas valide (différent de arl / kurl) |
| ER012 | Vous ne pouvez plus utiliser l'API (compte restreint) |
| ER013 | Vous ne pouvez plus utiliser l'API (vous avez atteint la limite d'usage pour aujourd'hui) |