API REST pour les développeurs

Accès API : devenez générateur de QR codes

Une API REST pour les QR codes dynamiques : créez tous les types, changez leur destination après impression, recevez chaque scan dans un webhook et envoyez les statistiques vers vos propres outils. Une seule clé API, du JSON à l’aller comme au retour.

Accès API inclus dans le plan EnterpriseDocumentation en anglais

curl -X POST 'https://api.v2.qrcodekit.com/api/qrs' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "typology": "/api/qr-typologies/0598466c-025c-11ef-83ba-06c4e69992ab",
    "title": "Spring catalogue",
    "input": { "url": "https://example.com/catalogue" }
  }'

Réponse JSON

{
  "uuid": "b7e9c2a4-1234-5678-9abc-def012345678",
  "title": "Spring catalogue",
  "pathName": "lV58V1",
  "state": 0,
  "typology": "/api/qr-typologies/0598466c-…"
}
  • REST + JSON-LD
  • Clé API dans un en-tête
  • Création en masse par CSV
  • Webhooks signés
  • Zapier, Make, n8n
  • MCP pour les assistants IA

Qu’est-ce que l’API QRCodeKIT ?

L’API QRCodeKIT est une API REST qui permet à vos propres logiciels de faire ce que fait le tableau de bord : créer des QR codes dynamiques de tous types, changer leur destination, les mettre en pause ou les supprimer, les télécharger et consulter leurs scans. Les requêtes portent une clé API dans l’en-tête X-Api-Key et les réponses sont en JSON-LD. Les scans et les formulaires envoyés peuvent aussi arriver dans vos systèmes en temps réel grâce à des webhooks signés. L’accès à l’API est inclus dans le plan Enterprise.

Démarrage rapide

Votre premier QR code en trois appels

Tout langage capable d’envoyer une requête HTTP convient.

  1. Créez une clé API

    Dans le tableau de bord, sous Settings → API Keys. Chaque clé appartient à un espace de travail : c’est le seul en-tête nécessaire.

    X-Api-Key: YOUR_API_KEY
  2. Choisissez le type de QR

    Listez les types et copiez l’@id de celui qu’il vous faut : Website, PDF, vCard, Menu…

    GET /api/qr-typologies
  3. Créez le QR code

    Envoyez le type, la destination et un titre. Conservez l’uuid de la réponse : il vous servira à modifier le code plus tard.

    POST /api/qrs

Démarrage rapide dans la documentation en anglais

Ce que vous pouvez construire

Une intégration pour tous les codes que vous imprimez

Changez la destination, pas l’impression

Un QR code dynamique pointe vers un lien court que vous contrôlez. Envoyez un PATCH avec seulement les champs à modifier et toutes les copies imprimées suivent. Pour désactiver un code sans le perdre, mettez-le en pause au lieu de le supprimer.

Gérer les QR codes
PATCH /api/qrs/{uuid}
Content-Type: application/merge-patch+json

{
  "input": {
    "url": "https://example.com/summer"
  }
}

Des milliers de codes à partir d’un CSV

Importez un CSV de QR codes de site web, un par ligne avec son nom, sa description et son URL, lancez une tâche en masse et suivez son état jusqu’à la fin, directement dans un projet si vous le souhaitez. Les mises à jour, suppressions et téléchargements fonctionnent aussi en masse.

Création de QR en masse
POST/api/assets/uploadcatalogue.csv
POST/api/qrs/bulk-createjob
GET/api/jobs/{uuid}

Votre marque sur chaque code

Chaque QR code accepte un design enregistré, un logo et des paramètres de design : les codes créés par vos systèmes ressemblent à ceux que votre équipe conçoit dans le tableau de bord.

Voir les champs
Options de design d’un QR code créé via l’API : cadre, formes des yeux et logo de la marque

Les scans, en données

Interrogez les visites totales et uniques sur n’importe quelle période, regroupées par heure, jour ou semaine et ventilées par pays, ville ou appareil. Les dates sont en UTC, prêtes pour vos tableaux de bord ou votre entrepôt de données.

Requêtes d’analyse
POST /api/analytics/query

{
  "date_range": {
    "start": "2026-10-01 00:00:00",
    "end": "2026-10-31 23:59:59",
    "interval": "1d"
  },
  "metrics": ["visits:total", "visits:unique"],
  "dimensions": ["geoip.country_name"]
}

Webhooks

Chaque scan dans vos systèmes en quelques secondes

Dans l’éditeur du QR, attribuez une URL de webhook à un code et choisissez ses événements : chaque scan, ou chaque formulaire envoyé avec ses réponses. QRCodeKIT envoie un POST signé à votre endpoint, ou à Zapier, Make ou n8n.

  • Deux événements : qr.scanned et form.submitted
  • Signature HMAC-SHA256 dans X-QRK-Signature, et un identifiant de livraison pour éviter les doublons
  • Nouvelles tentatives automatiques avec délai croissant si votre endpoint est indisponible ou lent
  • Application Zapier avec les déclencheurs New Scan, New Lead et New Payment, sans URL
Connecter un webhook
Votre endpoint reçoit
POST https://your-app.example/hooks/qrcodekit
X-QRK-Event: qr.scanned
X-QRK-Delivery: b7f3…
X-QRK-Signature: t=…,v1=…

{
  "event": "qr.scanned",
  "scanned_at": "2026-07-07T10:00:00+00:00",
  "first_scan": true,
  "qr": { "uuid": "…", "title": "My QR" },
  "project": { "uuid": "…", "name": "Campaign" }
}

Assistants IA

Ou laissez un assistant IA passer les appels

QRCodeKIT dispose aussi d’un serveur MCP : Claude, ChatGPT et d’autres assistants IA peuvent créer, lister et modifier vos QR codes dynamiques depuis une conversation. Ils se connectent avec OAuth : aucune clé API à coller.

Questions fréquentes sur l’API

Ce que demandent les équipes techniques avant de l’intégrer.

Quel plan inclut l’API QRCodeKIT ?

L’accès à l’API fait partie du plan Enterprise, avec les domaines personnalisés et la connexion SSO. Comparez les plans ou réservez une démo pour la mettre en place avec nous.

Comment s’authentifier ?

Envoyez votre clé API dans l’en-tête X-Api-Key. Chaque clé est liée à un espace de travail : aucun autre en-tête n’est nécessaire. Les clés se créent et se révoquent dans Settings → API Keys. Pour les applications où vos utilisateurs se connectent, l’API accepte aussi des jetons JWT dans Authorization: Bearer, avec l’en-tête X-Account-Id.

Puis-je changer la destination d’un QR code après l’avoir imprimé ?

Oui. Un QR code dynamique pointe vers un lien court : un PATCH /api/qrs/{uuid} avec la nouvelle URL met à jour toutes les copies imprimées. Envoyez seulement les champs modifiés, avec le type de contenu application/merge-patch+json.

Puis-je créer des QR codes en masse ?

Oui. Importez un CSV de QR codes de site web (nom, description et URL par ligne), lancez une tâche avec POST /api/qrs/bulk-create et interrogez /api/jobs/{uuid} jusqu’à ce que son état soit OK. Des endpoints permettent aussi de modifier, supprimer et télécharger des codes en masse.

Puis-je recevoir les scans en temps réel ?

Oui, avec les webhooks. Un QR code peut envoyer les événements qr.scanned et form.submitted à votre endpoint HTTPS, à Zapier, Make ou n8n, généralement en quelques secondes. Chaque livraison est signée en HMAC-SHA256 et renvoyée automatiquement si votre endpoint échoue.

Quel format utilise l’API ?

Du JSON à l’aller comme au retour. Les réponses suivent JSON-LD avec Hydra : chaque ressource a un @id et les collections arrivent par pages de 30 éléments, avec des liens hydra:view vers les pages suivantes.

Quelles erreurs peut-elle renvoyer ?

401 si la clé est absente ou révoquée, 402 si vous avez atteint la limite de QR codes de votre plan, 403 si le code appartient à un autre espace de travail, 404 si l’uuid n’existe pas, 422 en cas d’erreur de validation, avec un tableau violations qui nomme chaque champ invalide, et 429 si vous dépassez la limite de requêtes.

Puis-je l’utiliser sans écrire de code ?

Oui. L’application QRCodeKIT pour Zapier propose les déclencheurs New Scan, New Lead et New Payment, Make et n8n reçoivent les webhooks, et le serveur MCP permet à Claude, ChatGPT et d’autres assistants IA de gérer vos codes depuis une conversation.

Réserver une démo

Découvrez QRCodeKIT avec notre équipe

Vous déployez des QR codes dynamiques sur plusieurs marques, marchés ou équipes ? En 20 minutes, nous vous montrons comment l’intégrer à votre façon de travailler.

  • SSO et rôles d’équipe pour chaque marque
  • API, webhooks et création en masse
  • Votre propre domaine et revue de sécurité
Réserver une démo(s’ouvre dans un nouvel onglet)