API QR code pour développeurs
L'accès API est inclus dans les plans Business et Agency.
API QR code : points de terminaison CRUD
Listez et créez des QR codes via /api/v1/qrcodes ; consultez, modifiez et supprimez un QR code via /api/v1/qrcodes/:id. Une modification de destination_url ou de status par PATCH s'applique dès le scan suivant ; le code imprimé, lui, ne change jamais.
Clés API à droits limités
Générez des clés API depuis le tableau de bord avec uniquement les droits nécessaires : qrcodes:read, qrcodes:write, scans:read, conversions:write. Chaque clé est limitée à 300 requêtes par minute sur l'API REST, plus une limite distincte de 300 par minute sur les conversions, et liée à un seul espace de travail : conservez-la côté serveur.
Données de scan via l'API QR code
Parcourez page par page les événements de scan via /api/v1/scans, filtrés par qr_id et par nombre de jours : appareil, pays, référent et horodatage. Les mêmes données respectueuses de la vie privée que les graphiques du tableau de bord, sans aucune IP brute.
API de conversion
Envoyez en POST vos événements d'achat et d'inscription à /api/v1/conversions avec un event_name, un external_id pour la déduplication, un montant et une devise facultatifs, et le qr_slug qui a amené le client, afin d'attribuer le chiffre d'affaires au scan d'origine.
Notifications par webhooks
Abonnez vos points de terminaison aux événements qr.scanned (chaque scan réel, hors bots) et qr.lead_captured (chaque lead issu d'un formulaire hébergé). Les envois sont signés par HMAC et renvoyés avec un délai progressif en cas d'échec.
Pixel JavaScript
Un pixel léger (/pixel.js) envoie les conversions réalisées sur votre site à /api/collect et les relie au scan QR qui a amené le visiteur, grâce à une référence d'attribution propriétaire (le paramètre qr_ref du lien de destination, conservé dans le localStorage de votre site). Aucune prise d'empreinte de l'appareil ; lorsque Do Not Track est activé, la conversion est envoyée sans aucune propriété personnalisée ; et le pixel respecte le modèle de confidentialité de la plateforme, qui ne stocke aucune IP brute.
Les endpoints en pratique
Requêtes JSON entrantes et sortantes, authentifiées par clé API Bearer.
curl -X POST https://qrcode-suite.com/api/v1/qrcodes \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "dynamic_url",
"name": "Spring packaging insert",
"destination_url": "https://example.com/spring-landing"
}'# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/$QR_ID \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://example.com/summer-landing" }'curl -X POST https://qrcode-suite.com/api/v1/conversions \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_name": "purchase",
"external_id": "order-1042",
"amount": 49.90,
"currency": "EUR",
"qr_slug": "k7Qm2x"
}'Générer l'image en PNG ou SVG
GET /api/qr/:slug renvoie l'image scannable d'un code que vous avez créé : ?format=png ou ?format=svg, et ?size= en pixels (400 par défaut). Pour l'impression, ?dpi= (150, 300, 600 ou 1200) avec ?mm= produit un fichier de cette largeur physique en millimètres, la densité étant inscrite dans le PNG pour que le logiciel de mise en page le place à la bonne taille. L'extension du fichier suit ce qui a réellement été généré : un design que le rendu PNG ne sait pas aplatir est renvoyé en SVG, et nommé comme tel. Le point d'accès ne demande pas de clé API — l'image ne révèle rien de plus que le slug déjà imprimé sur le code — et il est limité en débit par IP hachée. Il ne génère que des codes existants dans un espace de travail : ce n'est pas un générateur anonyme.
# Screen image — no API key needed
curl -o insert.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&size=600"
# Print file: 25 mm wide at 300 DPI
curl -o insert-print.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&dpi=300&mm=25"Vous utilisez l'extension WordPress ?
L'extension WordPress expose ses propres routes REST sur votre site, sous /wp-json/qrcode-suite/v1/, authentifiées par des clés créées dans l'administration de l'extension (Authorization: Bearer ou X-API-Key). Elle ajoute aussi une commande WP-CLI wp qrcs avec create, scan-stats, bulk-export, webhook-test et label-generate. Ces routes agissent sur les codes stockés dans WordPress ; l'API de la plateforme ci-dessus agit sur votre espace de travail. Relier le site à la plateforme (sur activation) reprend ses codes, ses totaux de scans quotidiens et ses conversions WooCommerce dans votre tableau de bord.
Questions fréquemment posées
Qu'est-ce que QRCode Suite ?
QRCode Suite est une plateforme QR autonome : créez un compte gratuit et générez des QR codes dynamiques et personnalisés dans le navigateur — sans WordPress. Des connecteurs apportent les mêmes codes à WordPress et WooCommerce, où les commandes peuvent être attribuées à des QR codes spécifiques.
QRCode Suite fonctionne-t-il sans WordPress ?
Oui. QRCode Suite est un SaaS autonome : inscrivez-vous, créez vos QR codes et suivez les scans entièrement sur qrcode-suite.com. Le plugin WordPress est un connecteur optionnel qui ramène vos codes dans wp-admin et ajoute l'attribution des commandes WooCommerce.
QRCode Suite nécessite-t-il un abonnement séparé ?
Le plan Free est disponible gratuitement — sans carte bancaire. Les plans payants (Pro 9 €, Business 29 €, Agency 79 € par mois) débloquent codes illimités, règles de redirection et plus encore. Aucun frais par scan ne s'applique.
Quels types de QR codes QRCode Suite prend-il en charge ?
QRCode Suite prend en charge 22 types de QR codes : URL statique, URL dynamique, Texte brut, Téléphone, Email, Localisation, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Profil social, PDF, Téléchargement de fichier, Téléchargement d'app, Coupon, Événement calendrier, Formulaire de capture de leads, Collecte d'avis, Demande de gros, Récompense de fidélité et Payload personnalisé.
Puis-je modifier la destination d'un QR code après l'avoir imprimé ?
Oui. Les QR codes dynamiques utilisent une URL de redirection courte. Vous pouvez mettre à jour la destination depuis votre tableau de bord à tout moment, sans regénérer ni réimprimer le code.
QRCode Suite est-il conforme au RGPD ?
QRCode Suite est conçu dans l'esprit du RGPD : aucune adresse IP brute n'est jamais stockée — les visiteurs sont comptés via des hachages à clé —, le trafic des bots est filtré automatiquement et les événements de scan sont purgés à l'expiration de la fenêtre de rétention de votre forfait. Consultez votre équipe juridique pour vos obligations spécifiques.
Construisez sur l'API QRCode Suite
Clés API scopées et endpoints REST — inclus à partir de Business.