API de codes QR: comment intégrer la génération dans votre app
Guide avec exemples curl pour créer, gérer et télécharger des codes QR dynamiques via API REST
L'API REST de codigo-qr.es vous permet de générer, mettre à jour et analyser des codes QR directement depuis votre application, sans passer par le tableau de bord. Vous pouvez automatiser la création de QR pour des factures, des menus numériques ou des billets d'événement, et changer la destination d'un QR dynamique en production sans toucher au code imprimé. L'endpoint public fonctionne sans inscription. L'API complète, avec CRUD et statistiques, nécessite un plan Pro.
Quels endpoints possède l'API de codes QR?
L'API REST a huit endpoints: génération publique sans auth, et sept Pro pour créer, lister, mettre à jour, supprimer, télécharger et analyser des codes QR.
L'API de codigo-qr.es a deux tiers.
Endpoint public (sans compte):
`POST /api/v1/qr/render` génère un QR statique et renvoie l'image en base64. Limite: 50 requêtes par jour par IP.
Endpoints Pro (nécessitent une API key):
| Méthode | Chemin | Utilisation | |---------|--------|-------------| | `GET` | `/api/v1/qr` | Lister tous vos codes QR | | `POST` | `/api/v1/qr` | Créer un QR statique ou dynamique | | `GET` | `/api/v1/qr/{id}` | Détails d'un code QR | | `PATCH` | `/api/v1/qr/{id}` | Modifier destination ou nom | | `DELETE` | `/api/v1/qr/{id}` | Supprimer un code QR | | `GET` | `/api/v1/qr/{id}/image` | Télécharger l'image PNG ou SVG | | `GET` | `/api/v1/qr/{id}/stats` | Statistiques de scans |
Toutes les réponses Pro suivent `{ "data": {...}, "error": null }`.
Comment obtenir une API key de codes QR?
La API key est générée dans /panel/compte en un clic. Elle n'est disponible qu'avec un plan Pro actif et peut être révoquée depuis le même tableau de bord.
Étape 1. Créez un compte sur codigo-qr.es.
Étape 2. Activez le plan Pro. L'API complète est exclusive Pro à 5,99€/mois.
Étape 3. Allez sur /panel/compte et cliquez sur «Générer API key». Le token s'affiche une seule fois. Sauvegardez-le.
Ajoutez ce header à chaque requête:
```bash curl https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_votre_token" ```
Comment générer un code QR via API sans inscription?
L'endpoint /api/v1/qr/render génère des codes QR PNG ou SVG sans compte ni API key, limité à 50 requêtes par jour et par IP.
```bash curl -X POST https://codigo-qr.es/api/v1/qr/render \ -H "Content-Type: application/json" \ -d '{"value":"https://votredomaine.com","format":"png","size":512}' ```
Paramètres: `value` (obligatoire), `format` (png ou svg), `size` (256, 512 ou 1024).
Si vous dépassez 50 requêtes par jour, vous recevez `429 RATE_LIMITED` avec le header `Retry-After`.
Comment créer et mettre à jour des codes QR dynamiques via API?
POST /api/v1/qr crée le QR dynamique et retourne son ID. PATCH /api/v1/qr/{id} change la destination sans régénérer ni réimprimer le code.
Créer un QR dynamique:
```bash curl -X POST https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_votre_token" \ -H "Content-Type: application/json" \ -d '{ "label": "Menu restaurant mai", "type": "url", "value": "https://votrerestaurant.com/menu-mai", "is_dynamic": true, "tracking_mode": "redirect" }' ```
Changer la destination sans réimprimer:
```bash curl -X PATCH https://codigo-qr.es/api/v1/qr/{id} \ -H "Authorization: Bearer cqr_votre_token" \ -H "Content-Type: application/json" \ -d '{"destination": "https://votrerestaurant.com/menu-juin"}' ```
Pour quoi utilise-t-on l'API QR dans une entreprise?
L'API QR est utile quand vous devez générer ou mettre à jour plus de dix codes par mois: factures, menus numériques ou systèmes de billetterie.
E-commerce: L'ERP génère un QR par bon de livraison. Si l'URL change, `PATCH` met à jour la destination sans réimprimer.
Restaurants: Le TPV crée un QR par table. Le chef met à jour la carte dans le CMS; le QR redirige toujours vers la version actuelle.
Événements: Le système de billetterie génère un QR unique par billet. À l'entrée, le scanner vérifie via l'API.
Logistique: Chaque colis a un QR pour sa page de suivi. Les scans sont dans `GET /api/v1/qr/{id}/stats`.
Combien de requêtes l'API QR autorise-t-elle?
L'endpoint public accepte 50 requêtes par jour et par IP. Les endpoints Pro permettent 60 requêtes par minute et par utilisateur.
Tier public: 50 par jour par IP, sans inscription.
Tier Pro: 60 par minute par utilisateur, sans limite journalière totale.
En cas de dépassement, l'API retourne `429` avec les headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `Retry-After`.
Voir la documentation complète pour tous les paramètres.
§CODIGO-QR.ES / PRO
Commencez à intégrer l'API QR aujourd'hui
Créez votre compte, activez le plan Pro et générez votre première API key en moins de 2 minutes.
Preguntas frecuentes
- L'API de codes QR est-elle gratuite?
- L'endpoint public est gratuit, limité à 50 requêtes par jour par IP. L'API complète, avec API key, CRUD, image et statistiques, nécessite le plan Pro à 5,99€/mois.
- Les QR générés via API sont-ils lisibles par n'importe quel lecteur?
- Oui. Les codes suivent la norme ISO/IEC 18004. Ils fonctionnent avec l'appareil photo du téléphone et tout lecteur QR.
- Puis-je changer la destination d'un QR dynamique via API sans le réimprimer?
- Oui. PATCH /api/v1/qr/{id} met à jour l'URL de destination à tout moment. Le code QR imprimé reste identique.
- Le token de l'API est-il sécurisé?
- Seul le hash SHA-256 est stocké, jamais le token en clair. Affiché une fois à la génération. Révocable depuis /panel/compte à tout moment.
Jose Flores
Fundador de codigo-qr.es · codigo-qr.es
Jose Flores es fundador de codigo-qr.es, herramienta de generación de QR dinámicos y códigos de barras creada en Barcelona en 2026. Especializado en soluciones digitales para pequeños negocios, desarrolla herramientas que permiten a restaurantes, comercios y profesionales digitalizar su comunicación sin infraestructura técnica propia.
Más artículos