codigo-qr.es

§DEVELOPERS

Comment intégrer la génération de QR dans votre application?

L'API REST de codigo-qr.es génère des codes QR statiques et dynamiques, les gère et renvoie des images PNG ou SVG depuis n'importe quel langage en un seul appel.

Voir les endpoints

Nécessite le plan Pro

Puis-je utiliser l'API sans m'inscrire?

Oui. L'endpoint public génère des codes QR statiques sans compte ni API key, avec une limite de 50 requêtes par jour par IP.

Utilisez POST /api/v1/qr/render avec le contenu du QR, le format et la taille. Vous recevez l'image en base64. Sans inscription ni carte bancaire.

Exemple sans authentification

curl -X POST https://codigo-qr.es/api/v1/qr/render \
  -H "Content-Type: application/json" \
  -d '{"value":"https://yourdomain.com","format":"png","size":512}'

Comment fonctionne l'authentification de l'API?

L'API Pro utilise des API keys dans le header Authorization. La key est générée dans /panel/compte et est exclusive au plan Pro actif.

Ajoutez le header Authorization: Bearer avec votre token à chaque requête Pro. La key est générée depuis /panel/compte en un clic et peut être révoquée à tout moment.

Exemple avec API key

curl https://codigo-qr.es/api/v1/qr \
  -H "Authorization: Bearer cqr_your_token_here"

L'API key nécessite un plan Pro actif. Voir les plans et les tarifs

Quels endpoints possède l'API de codes QR?

Huit endpoints: un public sans auth pour la génération immédiate, et sept Pro pour créer, lister, mettre à jour, supprimer, télécharger l'image et voir les statistiques.

MéthodeCheminUtilisationPlan
POST/api/v1/qr/renderGénère un QR et renvoie l'image en base64. Sans auth.Public
GET/api/v1/qrListe tous vos codes QR avec pagination.Pro
POST/api/v1/qrCrée un code QR statique ou dynamique.Pro
GET/api/v1/qr/{id}Renvoie le détail complet d'un code QR.Pro
PATCH/api/v1/qr/{id}Met à jour la destination, le nom ou l'état.Pro
DELETE/api/v1/qr/{id}Supprime un code QR (suppression douce, réversible).Pro
GET/api/v1/qr/{id}/imageTélécharge l'image PNG ou SVG du code QR.Pro
GET/api/v1/qr/{id}/statsStatistiques de scans par jour et par pays.Pro

Pour quoi utilise-t-on l'API QR dans une entreprise?

Le e-commerce, les restaurants, les événements et la logistique l'utilisent pour automatiser la génération de QR dans les documents et systèmes sans intervention manuelle.

E-commerce

L'ERP génère un QR par bon de livraison avec le lien de suivi. Si l'URL change, PATCH met à jour la destination sans réimprimer.

Restaurants

Le TPV crée un QR par table à l'ouverture du service. 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 le QR via l'API et confirme s'il est valide.

Logistique

Chaque colis a un QR pointant vers sa page de suivi. Les scans sont enregistrés 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 par IP. Les endpoints Pro permettent 60 requêtes par minute par utilisateur avec une API key.

Lorsque vous dépassez la limite l'API renvoie 429 avec les headers X-RateLimit-Limit, X-RateLimit-Remaining et Retry-After pour savoir quand réessayer.

Public

50

req / day / IP

Pro

60

req / min / user

Questions fréquentes sur l'API QR

  • 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.

  • PNG et SVG. Utilisez le paramètre format=png ou format=svg. Les tailles disponibles sont 256, 512 et 1024 pixels.

  • Oui. PATCH /api/v1/qr/{id} met à jour l'URL de destination à tout moment. Le code QR imprimé reste identique; seule la destination change.

  • Seul le hash SHA-256 du token est stocké, jamais le token en clair. Il est affiché une seule fois lors de sa génération. Vous pouvez révoquer la key depuis /panel/compte.

  • Pas encore. L'API est REST standard et fonctionne avec n'importe quel client HTTP: curl, fetch, axios, requests Python, Guzzle PHP et similaires.

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.

Créer un compte gratuitVoir les tarifs