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)