API – premiers pas

QLI.fr propose une API REST pour créer des liens, consulter les statistiques, générer des QR codes et gérer les alias premium. L’API est incluse à partir de l’offre Starter.

1. Créez un jeton API

Dans l’application, ouvrez Paramètres → Jetons API, saisissez un nom et sélectionnez uniquement les portées nécessaires. Le jeton n’est affiché qu’une seule fois – conservez-le dans un gestionnaire de secrets.

Aller aux jetons API

2. Appelez l’API

Envoyez le jeton dans l’en-tête Authorization. Exemple de création d’un lien court :

Exemple de requête cURL

curl -X POST https://api.ra.sk/v1/links -H "Authorization: Bearer rask_…" -H "Content-Type: application/json" -d '{"destination_url":"https://example.com"}'

3. Spécification

Tous les endpoints, erreurs et la pagination sont décrits dans la spécification OpenAPI 3.1.

Télécharger la spécification OpenAPI (YAML)

Erreurs

Les erreurs ont toujours la forme {code, message, request_id, details}. Indiquez le request_id lorsque vous contactez le support.

Limites

Le quota mensuel d’API dépend de votre offre ; chaque jeton est limité à 600 requêtes par minute.