Statistiques QR-Code via API : Intégrer les scans dans vos propres rapports
Ce qui est comptabilisé
Same-QR compte pour chaque code dynamique le nombre de fois où il a été scanné. Un profil des personnes qui scannent n'est pas créé. La pertinence du comptage repose sur une bonne répartition : un code par lieu, support publicitaire ou succursale. Les statistiques d'un code incluent le total des scans, la date de création, le nombre de modifications de la cible et l'état inactif du code, par exemple si le compte dépasse la limite de son forfait.
Étape 1 : Créer une clé de lecture
Pour les rapports, vous n'avez jamais besoin de droits d'écriture. Dans le tableau de bord, sous Compte, « Accès pour CLI, scripts et agents », créez une clé avec « lecture seule » et nommez-la selon son objectif, par exemple « Rapport mensuel ». Elle peut interroger les chiffres, mais ne peut ni modifier ni supprimer. C'est particulièrement important pour les tâches qui s'exécutent sans surveillance.
Étape 2 : Récupérer les chiffres
Via l'API REST, la liste de tous les codes inclut déjà le nombre de scans par code ; pour les statistiques d'un code individuel, vous pouvez les récupérer spécifiquement :
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>/statsVia la ligne de commande, c'est plus court :
sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>Étape 3 : Construire le rapport
Les nombres de scans étant des sommes, vous enregistrez chaque mois un état et le comparez au mois précédent. La différence correspond au nombre de scans du mois. Rapports typiques :
- Rapport mensuel pour un client d'agence avec tous les codes de son projet client.
- Comparaison de plusieurs succursales, si chaque succursale dispose de ses propres codes et d'une étiquette distincte.
- Analyse d'une campagne d'affiches par lieu.
Pas besoin de propre programme : un assistant comme ChatGPT ou Claude avec Same-QR comme connecteur répond directement dans la conversation à « Quels sont les cinq codes les plus souvent scannés ? ».
Limites des chiffres
- Un scan ne signifie pas que quelqu'un a lu la page.
- Peu de scans peuvent être dus à l'emplacement, par exemple à un mauvais éclairage ou à un code trop petit.
- Pour le comportement sur le site web, vous avez besoin de l'analyse web. Les campagnes avec des paramètres utm relient les deux.
Conclusion : pourquoi Same-QR
Same-QR compte proprement et avec parcimonie des données, et vous obtenez les chiffres comme vous le souhaitez : dans le tableau de bord, par API, par CLI ou dans une conversation avec un assistant. Une clé de lecture suffit, et l'API est incluse dans chaque forfait.
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
Nombre total de scans, date de création, nombre de changements de cible et si le code est inactif. Same-QR ne collecte pas de données personnelles sur les personnes qui scannent.
Oui, en enregistrant un point de référence chaque mois et en calculant la différence. Un script avec clé de lecture fait cela automatiquement.
Non. « lecture seule » suffit et est le choix le plus sûr.
Réservez votre place avant le lancement.
Un e-mail dès le lancement de l’outil — avec les tarifs et l’offre gratuite. Pas de spam, désabonnement à tout moment.
- Votre compte gratuit est réservé — il n’y a de toute façon rien à payer pour l’instant
- 90 jours de modifications de destination illimitées au lieu de 30, réservé aux inscrits en avance
- Prix de lancement garanti, même si nous augmentons plus tard
En vous inscrivant, vous consentez à recevoir la newsletter. Vous pouvez retirer ce consentement à tout moment via le lien de désabonnement présent dans chaque e-mail.