API de liens courts et de codes QR
L’API REST de Krealo QR permet de créer des liens courts, de les lister, de modifier leur destination et de récupérer leur code QR depuis vos propres outils. Elle est réservée au forfait Pro, à 5,99 $ par mois, taxes en sus. Vous générez un jeton personnel dans la page de votre compte et vous l’envoyez dans l’en-tête Authorization.
curl -X POST https://qr.krealomedia.com/api/v1/links \
-H "Authorization: Bearer kqr_…" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/menu","slug":"menu"}'curl https://qr.krealomedia.com/api/v1/links?limit=25 \
-H "Authorization: Bearer kqr_…"curl https://qr.krealomedia.com/api/v1/links/menu -H "Authorization: Bearer kqr_…"
{ "slug": "menu", "short_url": "https://qr.krealomedia.com/menu", "url": "https://example.com/menu",
"active": true, "clicks": 42, "stats": { "by_day": { … }, "by_country": { "CA": 40 } } }curl -X PATCH https://qr.krealomedia.com/api/v1/links/menu \
-H "Authorization: Bearer kqr_…" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/menu-hiver","active":true}'curl "https://qr.krealomedia.com/api/v1/links/menu/qr?format=svg" -H "Authorization: Bearer kqr_…" -o menu.svg401 unauthorized · 402 pro_required · 404 not_found · 409 slug_taken · 429 rate_limited (120/min)
Authentification
L’API est réservée aux comptes Pro. Générez votre jeton personnel dans la page de votre compte, puis envoyez-le dans l’en-tête Authorization: Bearer <jeton>. L’adresse de base est https://qr.krealomedia.com/api/v1.
Routes disponibles
- GET /links : liste vos liens, avec pagination par curseur.
- POST /links : crée un lien (champ url, identifiant slug facultatif).
- GET /links/{slug} : renvoie un lien avec son nombre de clics.
- PATCH /links/{slug} : modifie l’url ou l’état actif.
- GET /links/{slug}/qr?format=svg|png : renvoie le code QR en noir et blanc.
Limite de débit
La limite est de 120 requêtes par minute. Au-delà, attendez la minute suivante avant de réessayer.
Destinations acceptées
Seules les adresses http et https sont acceptées. Les destinations dangereuses, comme javascript: ou data:, sont bloquées.
Voir aussi
Questions fréquentes
Qui peut utiliser l’API ?
Les comptes du forfait Pro. Le jeton personnel se génère dans la page du compte.
Quelle est la limite de requêtes ?
Elle est de 120 requêtes par minute.
Le code QR renvoyé par l’API peut-il avoir un logo ?
Non. La route /links/{slug}/qr renvoie un code QR en noir et blanc, en SVG ou en PNG. Le logo et les couleurs se règlent depuis l’application.