L'API REST de FRQR crée et gère vos liens courts et QR codes depuis votre code. Cette page résume l'essentiel ; la référence complète, avec tous les champs, se trouve dans votre espace développeur.

Ouvrir la référence complète

Vue d'ensemble de l'API

Documentation API de FRQR : créez liens courts, QR codes et deep links par programmation. Endpoints REST, SDK JS et Python, webhooks et exemples.

Démarrer en trois étapes

Créez un compte FRQR (la formule gratuite suffit pour tester).
Générez un jeton API dans les réglages développeur, avec les droits nécessaires.
Envoyez vos requêtes à https://app.frqr.app/api/v2/ avec l'en-tête Authorization: Bearer VOTRE_JETON.

Vérifier votre jeton

La route /me renvoie le compte associé au jeton. C'est le test le plus simple.

curl https://app.frqr.app/api/v2/me \
  -H "Authorization: Bearer VOTRE_JETON"

Créer un lien court

Envoyez la destination et un titre. L'en-tête Idempotency-Key (un identifiant unique par requête) évite de créer deux fois le même lien si la requête est rejouée.

curl https://app.frqr.app/api/v2/short-links \
  -H "Authorization: Bearer VOTRE_JETON" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7f1c2a9e-0b6d-4f43-9e1a-2d5c8b3e6a10" \
  -d '{"title":"Campagne printemps","destination_url":"https://www.exemple.fr/printemps"}'

Réponse (extrait) :

{
  "data": {
    "short_url": "https://go.votresite.fr/printemps",
    "destination_url": "https://www.exemple.fr/printemps",
    "title": "Campagne printemps"
  }
}

Routes principales

Méthode et route	Rôle	Droit requis
`GET /api/v2/me`	Compte associé au jeton	`-`
`GET /api/v2/short-links`	Lister vos liens courts	`assets:read`
`POST /api/v2/short-links`	Créer un lien court	`assets:write`
`GET /api/v2/short-links/{id}`	Lire un lien	`assets:read`
`PATCH /api/v2/short-links/{id}`	Modifier un lien (destination, titre…)	`assets:write`
`DELETE /api/v2/short-links/{id}`	Supprimer un lien	`assets:delete`
`GET /api/v2/qr-codes`	Lister vos QR codes	`assets:read`
`POST /api/v2/qr-codes`	Créer un QR code	`assets:write`
`GET /api/v2/qr-codes/{id}/stats`	Statistiques de scans	`assets:read`
`DELETE /api/v2/qr-codes/{id}`	Supprimer un QR code	`assets:delete`

Les réponses sont en JSON, avec les données dans la clé data. En cas d'erreur, l'API renvoie un code HTTP explicite (401 jeton invalide, 403 droit manquant, 422 champ invalide, 429 trop de requêtes) et un message dans la clé message.

Bonnes pratiques

Gardez le jeton côté serveur : ne l'intégrez jamais dans du code exécuté dans le navigateur.
Créez un jeton par application, avec le minimum de droits.
Utilisez une Idempotency-Key pour chaque création.
Utilisez les webhooks plutôt que d'interroger l'API en boucle.

Questions fréquentes

Comment obtenir un jeton API ?

Dans votre compte FRQR, ouvrez les réglages développeur et créez un jeton. Choisissez uniquement les droits nécessaires : lecture, écriture ou suppression.

L'API est-elle limitée en nombre de requêtes ?

Oui, la limite dépend de votre formule. Au-delà, l'API répond par le code 429 : attendez quelques secondes avant de réessayer.

Puis-je rejouer une requête sans créer de doublon ?

Oui. Envoyez le même en-tête Idempotency-Key : l'API renvoie le résultat de la première requête au lieu de créer un second lien.

Existe-t-il des SDK ?

Oui, en JavaScript et en Python. Ils reprennent les mêmes routes et gèrent l'authentification pour vous.

Puis-je utiliser l'API depuis un assistant IA ?

Oui, avec le serveur MCP de FRQR : l'assistant utilise votre jeton API et n'a accès qu'à ce que ce jeton autorise.

Documentation API : ce qu'il faut retenir

FRQR propose une formule gratuite, sans carte bancaire et sans limite de durée : 25 liens actifs, 5 QR codes dynamiques et 3 dossiers. Les QR codes statiques sont illimités sur toutes les formules. Les formules payantes lèvent les quotas, et l'abonnement annuel revient à 10 mois de mensuel, soit 2 mois offerts.

Les statistiques de FRQR sont mesurées sans cookie et sans identifiant stocké sur l'appareil du visiteur : aucune bannière de consentement n'est nécessaire pour ces mesures. Les données sont hébergées en France et conservées 13 mois au maximum.

Besoin d'aide pour l'intégration ?

Écrivez-nous avec un exemple de requête (sans votre jeton) : l'équipe vous répond en français.

Lire la référence complète

Contacter le support