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, opérations en masse et webhooks en temps réel. D'un code unique à 500 par demande.

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. Générez jusqu'à 500 codes par requête avec les endpoints 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 des SDK pour Node.js, Python et des exemples cURL.

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 '{
"type": "url",
"data": "https://example.com",
"style": { "foreground": "#238636" }
}'
Réponse
201 Created
{
"id": "qr_abc123",
"type": "url",
"shortUrl": "https://qr-verse.com/r/abc123",
"image": "https://qr-verse.com/api/v1/qr-codes/qr_abc123/image.svg"
}

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.

Opérations en masse

Créez jusqu'à 500 QR codes en une seule requête API. Idéal pour les catalogues e-commerce, les billets d'événements ou la gestion d'inventaire.

API Analytique

Récupérez les données de scan par programmation. Total des scans, évolution dans le temps, répartition géographique, types d'appareils et données de source.

É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 Business prennent en charge plusieurs clés pour différents environnements.

Limitation de débit

En-têtes de limite de débit clairs dans chaque réponse. 30 requêtes par 60 secondes par clé API. X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset à chaque appel.

Accès API par plan

L'accès API commence avec Pro. Business débloque les opérations en masse, les webhooks et plusieurs clés API pour les environnements d'équipe.

Fonctionnalité
Gratuit
EUR 0/mois
Pro
EUR 4,99/mois
Business
EUR 12,99/mois
Accès API REST
Gestion des clés API
Créer / Lire / Modifier / Supprimer
Tous les types QR (URL, vCard, WiFi...)
Récupération des données analytiques
Limite de débit030 / min30 / min
Opérations en masse (par requête)Jusqu'à 500
Notifications webhook
Clés API multiples
Réponses API en marque blanche
Documentation OpenAPI / Swagger

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. Créez 500 codes en masse par appel API pour les grands inventaires.

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.

Documentation OpenAPI

Spécification OpenAPI 3.0 complète avec interface Swagger interactive. Testez les endpoints directement depuis la documentation. Chaque schéma de requête et de réponse est documenté.

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 ?
Tous les types de QR codes disponibles dans l'interface web le sont aussi via l'API : URL, vCard (cartes de contact), identifiants WiFi, e-mail, SMS, texte brut et bien d'autres. Chaque type possède son propre schéma de données documenté dans la spécification OpenAPI.
Comment fonctionne la création de QR codes en masse ?
Les utilisateurs du plan Business peuvent envoyer un tableau de jusqu'à 500 objets QR code dans une seule requête POST vers le endpoint bulk. Chaque code peut avoir des types, données et styles différents. L'API retourne tous les codes créés avec leurs identifiants et URL courtes.
Que se passe-t-il lorsque j'atteins la limite de débit ?
Chaque réponse API inclut des en-têtes de limite de débit : X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. En cas de dépassement, l'API retourne un code 429 avec l'horodatage de réinitialisation. La limite est de 30 requêtes par fenêtre de 60 secondes par clé API.
Puis-je personnaliser l'apparence des QR codes via l'API ?
Oui. L'API accepte des paramètres de style incluant la couleur de premier plan, la couleur d'arrière-plan, le niveau de correction d'erreur et le format de sortie (SVG ou PNG). Les mêmes options de personnalisation que dans le générateur web sont disponibles via l'API.
Comment fonctionnent les webhooks pour les événements de scan ?
Les utilisateurs du plan 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 : identifiant QR, horodatage, localisation (pays/ville), type d'appareil et 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 (EUR 4,99/mois) ou Business (EUR 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. Vous pouvez récupérer le nombre total de scans, leur évolution dans le temps (quotidien/hebdomadaire/mensuel), la répartition géographique par pays et ville, les types d'appareils et les principales sources pour n'importe lequel de vos QR codes.

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 par lots - créer des centaines ou des milliers de codes QR uniques en un seul appel API, 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 le niveau Business.

L'expérience développeur était une priorité de conception dès le début. La spécification OpenAPI est publiée à une URL stable et maintenue synchronisée avec chaque version de l'API. Des packages SDK officiels sont disponibles pour Node.js, Python et PHP. La documentation interactive avec exécution de requêtes en direct est disponible directement dans le tableau de bord QR-Verse une fois que vous avez une clé API.

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. Documentation OpenAPI complète incluse.

Commencer à développer