Aller au contenu principal
REST API

Générez des QR Codes à Grande Échelle avec Notre API REST

Intégrez la création, la gestion et l'analytique des codes QR dans n'importe quelle application. API JSON RESTful avec authentification par clé API, export ZIP en masse et webhooks en temps réel.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

L'API REST QR-Verse permet aux développeurs de créer, gérer et suivre des QR codes de manière programmatique. Exportez jusqu'à 50 codes existants en ZIP via l'endpoint d'export en masse, recevez des notifications de scan en temps réel via des webhooks et accédez à des analyses détaillées. Authentifiez-vous avec une simple clé API et commencez l'intégration en quelques minutes avec n'importe quel client HTTP.

Créez un QR code en quelques secondes

Une seule requête POST suffit. Envoyez vos données et obtenez un QR code scannable avec une URL courte traçable et une image téléchargeable.

Requête
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring campaign",
"destination_url": "https://example.com"
}'
Réponse
201 Created
{
"data": {
"id": "qr_abc123",
"name": "Spring campaign",
"qr_type": "url",
"destination_url": "https://example.com",
"is_active": true,
"redirect_slug": "abc123",
"tags": [],
"created_at": "2026-10-09T12:00:00Z"
}
}

Tout ce qu'il faut pour développer

Une API complète pour gérer le cycle de vie des QR codes. De la création et personnalisation au suivi des scans et aux notifications en temps réel.

Opérations CRUD complètes

Créez, lisez, modifiez et supprimez des QR codes par programmation. Tous les types QR pris en charge - URL, vCard, WiFi, e-mail, SMS et plus.

Export ZIP en masse

Exportez jusqu'à 50 QR codes existants en fichier ZIP en une seule requête API. Téléchargement PNG ou SVG avec le style d'origine préservé.

API Analytique

Récupérez les données de scan par programmation. Totaux sur une période et un enregistrement par scan : heure, pays, ville, type d'appareil, système, navigateur et paramètres UTM.

Événements webhook

Recevez des notifications HTTP en temps réel lorsque vos QR codes sont scannés. Déclenchez des workflows dans votre CRM, outil d'analyse ou d'automatisation.

Gestion des clés API

Générez, renouvelez et révoquez des clés API depuis votre tableau de bord. Les plans Pro et Business prennent en charge plusieurs clés pour différents environnements.

Limitation de débit

La création de QR codes via l'API est limitée à 30 requêtes par 60 secondes par clé API. Au-delà, l'API répond avec le statut 429.

Accès API par plan

L'accès API commence avec Pro. Business ajoute l'import en masse depuis un fichier CSV dans l'interface web et des limites plus élevées de webhooks et de clés API pour les environnements d'équipe.

Fonctionnalité
Gratuit
EUR 0/mois
Pro
4,99 €/mois
Business
12,99 €/mois
Accès API REST
Gestion des clés API
Créer / Lire / Modifier / Supprimer
QR codes dynamiques à partir d'une URL de destination
Récupération des données analytiques
Limite de débit (création de codes)030 / min30 / min
Export ZIP en masse (jusqu'à 50 codes)
Notifications webhook
Clés API multiples

Conçu pour votre environnement technique

Que vous gériez une boutique en ligne, un pipeline commercial ou des campagnes marketing - l'API QR-Verse s'intègre à votre flux de travail existant.

Plateformes e-commerce

Générez automatiquement des QR codes pour chaque produit de votre catalogue. Redirigez vers les pages produit, ajoutez-les aux emballages ou intégrez-les aux reçus. Exportez les codes existants en fichier ZIP via l'API pour vos workflows d'impression et d'emballage.

Shopify, WooCommerce ou boutiques personnalisées

CRM et outils commerciaux

Créez des QR codes personnalisés pour les supports commerciaux, cartes de visite ou portails clients. Utilisez les webhooks pour enregistrer les scans comme activités CRM et suivre l'engagement par contact.

HubSpot, Salesforce, Pipedrive

Automatisation marketing

Intégrez des QR codes dynamiques dans vos campagnes e-mail, publicités imprimées ou supports événementiels. Récupérez les analyses des scans via API pour mesurer le ROI de vos campagnes aux côtés de vos données marketing existantes.

Mailchimp, ActiveCampaign, Zapier

Expérience développeur

Conçu par des développeurs, pour des développeurs. Réponses prévisibles, documentation claire et versionnage stable pour livrer en toute confiance.

Clés API à portée limitée

Donnez à chaque clé uniquement les droits dont elle a besoin : qr:read, qr:write, qr:create et analytics:read. Une clé sans la portée d'un endpoint reçoit un 403, et un jeton de session connecté n'est pas accepté par l'API.

Réponses JSON

Réponses JSON propres et cohérentes avec une structure prévisible. Chaque endpoint retourne le même format - objets de données, de pagination et d'erreurs sur lesquels vous pouvez compter.

Gestion des erreurs

Réponses d'erreur structurées avec codes HTTP, codes d'erreur lisibles par machine et messages compréhensibles. Déboguez rapidement sans tâtonner.

Versionnage de l'API

Endpoints versionnés (v1) avec garanties de compatibilité descendante. Les changements majeurs n'arrivent que dans de nouvelles versions majeures, assurant la stabilité de votre intégration.

Points de terminaison disponibles
GET/api/v1/qr-codes
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
GET/api/v1/qr-codes/:id/scans

Questions fréquentes

Quelle méthode d'authentification l'API QR-Verse utilise-t-elle ?
L'API utilise l'authentification par clé API via des tokens Bearer. Incluez votre clé dans l'en-tête Authorization sous la forme "Bearer VOTRE_CLÉ_API". Vous pouvez générer et gérer vos clés API depuis votre tableau de bord.
Quels types de QR codes puis-je créer via l'API ?
L'API crée des QR codes dynamiques qui redirigent vers une URL de destination : envoyez un name et une destination_url à POST /api/v1/qr-codes. Le champ type est une étiquette (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto ou social) et le contenu est toujours l'URL. Les codes avec leurs propres données, comme une vCard ou un réseau WiFi, se créent dans l'application web.
Comment fonctionne l'export ZIP en masse ?
Les utilisateurs des plans Pro et Business peuvent exporter jusqu'à 50 QR codes existants en fichier ZIP via POST /api/qr/bulk-export, avec une session ou une clé API disposant de la portée qr:read. Indiquez les identifiants des codes à exporter et choisissez le format PNG ou SVG. L'API retourne un fichier ZIP contenant chaque code avec son style d'origine préservé.
Que se passe-t-il lorsque j'atteins la limite de débit ?
La création d'un code (POST /api/v1/qr-codes) est limitée à 30 requêtes par fenêtre de 60 secondes par clé API. Au-delà, l'API répond avec le statut 429 et le message "Rate limit exceeded". Les réponses ne contiennent ni en-têtes de limite de débit ni heure de réinitialisation : attendez une minute puis réessayez.
Puis-je personnaliser l'apparence des QR codes via l'API ?
Pas via l'API v1. Un code créé via l'API démarre avec le style par défaut (noir sur blanc) ; vous pouvez ensuite le personnaliser dans l'application web. Les couleurs, la correction d'erreur et le format de sortie ne sont pas des paramètres de POST /api/v1/qr-codes.
Comment fonctionnent les webhooks pour les événements de scan ?
Les utilisateurs des plans Pro et Business peuvent enregistrer des URL webhook depuis le tableau de bord. Lorsqu'un de vos QR codes est scanné, nous envoyons une requête POST à votre URL webhook avec les détails du scan : l'événement et un horodatage, plus l'identifiant et le nom du QR code, pays et ville, type d'appareil, système, navigateur, scan unique ou non et paramètres UTM (pas de source). Les webhooks utilisent des signatures HMAC pour la vérification.
L'API est-elle disponible sur l'offre gratuite ?
Non. L'accès à l'API requiert un plan Pro (4,99 €/mois) ou Business (12,99 €/mois). L'offre gratuite inclut le générateur QR en ligne mais pas l'accès API par programmation.
Puis-je récupérer les données analytiques via l'API ?
Oui. Les plans Pro et Business incluent l'accès API aux analyses de scan, avec une clé disposant de la portée analytics:read. GET /api/v1/qr-codes/:id/scans renvoie les scans d'un QR code page par page (heure, pays, ville, type d'appareil, système, navigateur, unique ou non, paramètres UTM) et un résumé avec le total des scans, les scans et scans uniques de la période et la durée de la période. Il ne renvoie ni répartition par jour, semaine ou mois ni source : agrégez les enregistrements de votre côté.

Intégrer les codes QR dans votre workflow

L'API REST QR-Verse vous permet de générer, gérer et récupérer des analyses de scan pour des codes QR par programmation. Chaque opération disponible dans le tableau de bord est accessible via API, ce qui signifie que votre équipe de développement peut intégrer la génération de codes QR directement dans des outils internes, des plateformes e-commerce, des pipelines de traitement ou des produits SaaS sans étapes manuelles.

Les schémas d'intégration courants incluent la génération programmatique - créer des codes QR uniques, une requête à la fois, chacun avec une URL de destination distincte et des métadonnées personnalisées optionnelles. Idéal pour la sérialisation de produits, les systèmes de tickets ou les programmes de cartes de fidélité. L'API retourne chaque code généré en SVG ou PNG dans le corps de réponse.

L'endpoint d'analyses de scan donne un accès en temps réel aux mêmes données visibles dans le tableau de bord - scans totaux, scans uniques, répartition géographique, répartition par appareil et données de séries temporelles - le tout en JSON structuré. Cela signifie que vous pouvez envoyer les événements de scan QR directement vers votre entrepôt de données, CRM ou outil de reporting. Le support webhook est disponible sur les niveaux Pro et Business.

L'API est volontairement petite : six endpoints sous /api/v1, du JSON en entrée et en sortie, et une clé API avec des portées pour l'accès. Les endpoints sont listés sur cette page, et l'exemple ci-dessous montre une requête et sa réponse. Il n'y a ni package SDK ni documentation interactive hébergée : un simple client HTTP comme cURL ou fetch suffit.

Plan Pro requis

Obtenez votre clé API

Souscrivez un plan Pro ou Business, générez votre clé API depuis le tableau de bord et commencez à envoyer des requêtes en quelques minutes.

Commencer à développer