Pour les développeurs

API de QR code

Générez des QR codes et lisez les statistiques de scan directement depuis votre propre code. L'API CodesQR est une petite interface REST prévisible qui renvoie du JSON, disponible sur tout compte CodesQR.

Obtenir votre clé API Voir un exemple

Authentification

Chaque requête est authentifiée avec une clé API secrète envoyée en tant que jeton bearer. Créez une clé depuis votre tableau de bord sous Paramètres, gardez-la côté serveur et ne l'exposez jamais dans le code client. Toutes les requêtes passent par HTTPS vers https://api.codesqr.com.

Authorization: Bearer sk_live_your_api_key

Points de terminaison

POST /v1/qr

Créer un QR code statique ou dynamique.

GET /v1/qr/{id}

Récupérer un seul QR code et les URL de ses images.

PATCH /v1/qr/{id}

Changer la destination ou le titre d'un code dynamique.

GET /v1/qr/{id}/stats

Lire les statistiques de scan d'un code dynamique.

GET /v1/qr

Lister les QR codes de votre compte.

DELETE /v1/qr/{id}

Supprimer un QR code.

Créer un QR code

Envoyez un POST vers /v1/qr avec le type et la cible. Définissez dynamic: true pour obtenir un code modifiable et traçable que vous pouvez mettre à jour plus tard. La réponse inclut des URL d'images PNG et SVG prêtes à l'emploi.

Requête

curl https://api.codesqr.com/v1/qr \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "target": "https://example.com/spring-sale",
    "dynamic": true,
    "title": "Spring Sale Poster",
    "color": { "dark": "#059669", "light": "#ffffff" },
    "format": "png"
  }'

Réponse

{
  "id": "qr_8fK2p1Qz",
  "type": "url",
  "target": "https://example.com/spring-sale",
  "dynamic": true,
  "short_url": "https://csqr.io/8fK2p1Qz",
  "image_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.png",
  "svg_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.svg",
  "scans": 0,
  "created_at": "2026-07-18T10:24:00Z"
}

Mettre à jour un code dynamique

Comme un QR code dynamique conserve le même motif imprimé, vous pouvez le pointer ailleurs à tout moment avec un PATCH. Les codes déjà imprimés continuent de fonctionner, sans réimpression requise.

Requête

curl -X PATCH https://api.codesqr.com/v1/qr/qr_8fK2p1Qz \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "target": "https://example.com/summer-sale" }'

Lire les statistiques de scan

Pour les codes dynamiques, récupérez les statistiques de scan avec un GET vers /v1/qr/{id}/stats. Vous obtenez les totaux, une répartition quotidienne et une ventilation par appareil que vous pouvez représenter graphiquement ou exporter.

Requête

curl https://api.codesqr.com/v1/qr/qr_8fK2p1Qz/stats \
  -H "Authorization: Bearer sk_live_your_api_key"

Réponse

{
  "id": "qr_8fK2p1Qz",
  "total_scans": 1842,
  "unique_scans": 1310,
  "range": "last_30_days",
  "by_day": [
    { "date": "2026-07-16", "scans": 74 },
    { "date": "2026-07-17", "scans": 91 },
    { "date": "2026-07-18", "scans": 63 }
  ],
  "by_device": { "mobile": 1521, "desktop": 248, "tablet": 73 }
}

Limites de débit et erreurs

L'API renvoie des codes de statut HTTP standard : 200 en cas de succès, 400 pour une requête mal formée, 401 pour une clé incorrecte, et 429 lorsque vous dépassez la limite de débit de votre formule. Les réponses d'erreur incluent un code lisible par machine et un message lisible par un humain. Vous préférez ne pas coder du tout ? Vous pouvez tout créer et gérer à la main dans l'application, ou explorer d'abord tous les types de QR codes.

Prêt à développer ?

Créez un compte CodesQR gratuit, générez une clé API dans les Paramètres et créez votre premier QR code avec une seule requête.

Créer un compte gratuit

Votre QR code traçable est à une minute de vous

Pointez un code vers n'importe quel lien ou fichier, suivez chaque scan et changez la destination dès que vous en avez besoin.

Créer mon QR code gratuit

Gratuit à vie
Sans carte bancaire
Prêt en quelques minutes