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 Enterprise•Documentation 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.
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_KEYChoisissez le type de QR
Listez les types et copiez l’@id de celui qu’il vous faut : Website, PDF, vCard, Menu…
GET /api/qr-typologiesCré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
Endpoints
Tout ce que fait le tableau de bord, en HTTP
Les principaux endpoints. La référence complète est générée à partir de la description OpenAPI de l’API elle-même : elle correspond toujours au service en production.
Référence complète des endpoints →en anglais- POST
/api/qrsCrée un QR code de n’importe quel type→ - GET
/api/qrsListe les QR codes de votre espace de travail, 30 par page→ - GET
/api/qrs/{uuid}Récupère un QR code→ - PATCH
/api/qrs/{uuid}Change sa destination, son titre ou son état→ - DELETE
/api/qrs/{uuid}Le supprime définitivement ; vous pouvez aussi le mettre en pause→ - GET
/api/qr-download/{uuid}Télécharge l’image du QR code→ - POST
/api/qrs/bulk-createEn crée des milliers à partir d’un CSV, en tâche de fond→ - POST
/api/analytics/queryInterroge les visites par date, pays, ville ou appareil→
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 →/api/assets/uploadcatalogue.csv/api/qrs/bulk-createjob/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 →
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.scannedetform.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
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.
Claude
Ajoutez le connecteur QRCodeKIT dans Claude, Claude Code ou l’application de bureau.
en anglaisChatGPT
Utilisez l’application QRCodeKIT dans ChatGPT : elle demande confirmation avant de créer ou de modifier un code.
en anglaisCursor, VS Code, Windsurf…
Tout client MCP via Streamable HTTP : mcp.v2.qrcodekit.com/mcp
en anglais
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.