Note : l'API n'est accessible qu'avec une, et une seule, clé que vous pouvez obtenir une fois connecté. Dans les exemples ci-dessous, la clé choisie arbitrairement sera 1234567890.

• Réduire une URL : https://ar1.se/api/v1/1234567890/addurl/$url/$prefix/$reducer/$expire
  Où :
  • $url est l'URL à réduire, avec les caractères URL-encodés. Seules les URL commençant par "http" ou "https" sont acceptées.
  • $prefix (optionnel) commence par la chaine "p:", limité à 5 caractères et désigne le préfixe souhaité devant l'id de réduction.
  • $reducer (optionnel) commence par la chaine "r:", limité à 10 caractères et désigne le résultat souhaité comme identifiant de réduction.
  • $expire (optionnel) donne la date d'expiration du lien sous forme de timestamp depuis l'epoch UNIX, où 0 signifie qu'il n'expire pas (ce qui est fait par défaut lorsque ce paramètre n'est pas donné), et où toute date antérieure à la date actuelle sera ignorée.
  Exemples :
  • https://ar1.se/api/v1/1234567890/https%3A%2F%2Far1.se%2Fapi_v1.doc.php
    renvoie une réponse de la forme :
    {"error":false,"msg":["https:\/\/ar1.se\/2jHg8mu86U"]}
  • https://ar1.se/api/v1/1234567890/https%3A%2F%2Far1.se%2Fapi_v1.doc.php/p:doc_
    renvoie une réponse de la forme :
    {"error":false,"msg":["https:\/\/ar1.se\/doc_2jHg8mu86U"]}
  • https://ar1.se/api/v1/1234567890/https%3A%2F%2Far1.se%2Fapi_v1.doc.php/p:doc_/r:apiv1
    renvoie une réponse de la forme :
    {"error":false,"msg":["https:\/\/ar1.se\/doc_apiv1"]}
  • https://ar1.se/api/v1/1234567890/https%3A%2F%2Far1.se%2Fapi_v1.doc.php/r:doc_apiv1
    renvoie une réponse de la forme :
    {"error":false,"msg":["https:\/\/ar1.se\/doc_apiv1"]}
• Lister les URL réduites par clé d'API : https://ar1.se/api/v1/1234567890/listurls
  Exemples de retour :
  • {"error":false,"msg":["https:\/\/ar1.se\/2jHg8mu86U","https:\/\/ar1.se\/9Met37Et7M"]}
  • {"error":false,"msg":[]}
  • {"error":true,"msg":["Invalid key."]}
• Supprimer une URL : https://ar1.se/api/v1/1234567890/delurl/$url
  Où :
  • $url est la partie réduite de l'URL à supprimer.
  • ... il peut y avoir plusieurs paramètres d'un coup.
  Exemples :
  • https://ar1.se/api/v1/1234567890/2jHg8mu86U
    renvoie une réponse de la forme :
    {"error":false,"msg":["2jHg8mu86U"]}
  • https://ar1.se/api/v1/1234567890/5eGW7XhoEg/YtYRD68R6V
    renvoie une réponse de la forme(URL réduites présentes) :
    {"error":false,"msg":["5eGW7XhoEg","YtYRD68R6V"]}
  • https://ar1.se/api/v1/1234567890/5eGW7XhoEg/YtYRD68R6V
    renvoie une réponse de la forme(URL réduites déjà supprimées) :
    {"error":true,"msg":[]}
• Renouveler sa clé d'API, sans supprimer ses URL réduites : https://ar1.se/api/v1/1234567890/newkey
  Exemples de retour :
  • {"error":false,"msg":["IwIyBlS2zMxVcen4kubKhlDfj9z"]}
  • {"error":true,"msg":["Invalid key."]}
• Supprimer sa clé d'API, qui supprimera toutes ses URL réduites : https://ar1.se/api/v1/1234567890/delkey
  Exemples de retour :
  • {"error":true,"msg":["API key deleted."]}
  • {"error":true,"msg":["Invalid key."]}