API QR Code : créer, modifier et évaluer automatiquement des QR codes

À quoi sert une API QR Code

Une API QR Code est une interface de programmation : au lieu de cliquer dans le navigateur, votre programme envoie des demandes au service de QR Code et reçoit des réponses. Ainsi, des codes sont générés directement depuis une boutique, un système de gestion de stock, un script ou un tableau.

Cela vaut la peine dès que le travail se répète : cent codes pour des tables ou des produits, des rapports de scan mensuels, le changement de nombreuses cibles après un relance. Et cela ne fonctionne qu'avec des codes dynamiques. Un QR code dynamique de Same-QR contient une adresse courte et constante, la cible derrière est chez nous et peut être modifiée à tout moment, sans avoir besoin de réimprimer.

Ce que couvre l'API Same-QR

L'API REST se trouve sous https://sameqr.com/api/v1. Elle appelle les mêmes fonctions que le tableau de bord, avec les mêmes limites de forfait et vérifications :

• Lister, lire, créer, modifier et supprimer des QR codes.
• Les statistiques d'un code : scans, date de création, nombre de changements de cible.
• Créer, modifier, publier et mettre hors ligne des pages hébergées telles que carte, liste de prix, horaires d'ouverture, page de liens, action, cave à vin, étiquette électronique de vin et contact.
• Lire une carte à partir de jusqu'à quatre photos ou d'un PDF.
• Gérer les étiquettes et les projets clients et lire les demandes des formulaires de contact.

Une description lisible par machine de toutes les demandes se trouve sous /api/v1/openapi.json, le guide sur sameqr.com/entwickler.

Clé API et droits

Vous définissez la clé dans le tableau de bord sous Compte, section « Accès pour CLI, scripts et agents ». Vous choisissez l'un des trois niveaux, « lecture seule », « lecture + écriture » (création, modification des noms et textes) ou « complet » (modification des cibles, mise hors ligne, suppression), et une durée de 30, 90, 180 ou 365 jours, si nécessaire également illimitée. La clé commence par sqr_live_ et s'affiche exactement une fois. Nous ne stockons qu'une somme de contrôle.

Une clé autorisée en lecture seule reçoit un refus clair pour chaque demande modifiante. Pour les rapports et les analyses, c'est le bon choix. Tout ce qui est modifié, vers où mène un code imprimé, est également protégé : les modifications de cible, la mise hors ligne et la suppression nécessitent le niveau « complet » et une confirmation avec l'état lu précédemment, et via l'API, il n'y en a au maximum 10 par heure et 30 par jour. Dans le tableau de bord, cette limite n'existe pas. Chaque clé peut être révoquée à tout moment et devient alors immédiatement invalide.

Un flux de travail typique

La clé doit figurer dans l'en-tête Authorization, jamais dans une URL. Vous définissez la clé au préalable comme variable d'environnement. Voici comment lister vos codes et modifier la cible d'un code :

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

curl -X PATCH https://sameqr.com/api/v1/qr/<id> \
  -H "Authorization: Bearer $SAMEQR_API_KEY" -H "Content-Type: application/json" \
  -H "X-Confirm: <stand>" \
  -d '{"targetUrl":"https://example.com/karte-neu"}'

La valeur de X-Confirm, l'état, est fournie par la demande de lecture sur /api/v1/qr/<id>. Seules les données que vous envoyez sont modifiées. Pour s'assurer que personne n'a modifié le même code en cours de route, on envoie l'état lu comme _rev. Si des modifications ont eu lieu, rien n'est écrasé, et la réponse contient l'état actuel. Les erreurs reviennent toujours dans le même format, avec le statut, le code et un message compréhensible.

Limites et bonnes pratiques

Par clé, au maximum 120 demandes par minute. S'ajoute une limite horaire dépendant de l'offre : 60 dans l'offre gratuite, 300 dans Start, 1 000 dans Pro et 5 000 dans Agentur. Les limites détectent les erreurs, comme un script dans une boucle infinie, et ne gênent pas une utilisation légitime.

• Commencez par tester avec une clé en lecture seule, puis passez à l'écriture.
• Testez les nouveaux flux sur un code unique et scannez-le avec un téléphone.
• Évitez la suppression là où une nouvelle cible suffit. Les codes supprimés et leurs liens courts ne sont pas récupérables.
• Créez une clé distincte pour chaque programme et conservez-la dans un gestionnaire de mots de passe ou une variable d'environnement.

Conclusion : pourquoi Same-QR

Same-QR vous fournit l'API non pas comme un supplément coûteux, mais dans chaque offre, avec les mêmes fonctionnalités que dans le tableau de bord : codes, statistiques, cartes, pages hébergées, étiquettes et projets. S'ajoutent des droits clairs par clé, des messages d'erreur honnêtes et une vérification nocturne de toutes les cibles, qui vous informe par e-mail si l'une d'elles n'est pas accessible.

Lancez-vous tout de suite : inscrivez-vous gratuitement sur sameqr.com, deux codes QR dynamiques sont gratuits pour toujours. L’API, la CLI et le serveur MCP sont inclus dans chaque offre, la documentation se trouve sur sameqr.com/entwickler.

Questions fréquentes