← Toutes les fonctionnalités

API REST — créez et gérez vos QR codes depuis vos outils

Connectez votre CRM, votre outil d'automatisation ou vos scripts à QR Suisse : créez, modifiez et supprimez des QR codes dynamiques et lisez leurs statistiques via l'API. Plans Pro et Entreprise.

Pro · Entreprise

L'API REST de QR Suisse permet à vos outils de créer, lire, modifier et supprimer des QR codes de type lien ou carte de visite, de télécharger leur image en PNG ou en SVG et de lire leurs statistiques de scan. Vos outils peuvent aussi archiver et réactiver un QR code, chercher et filtrer la liste, lire le quota de créations restant et relancer une création sans créer de doublon, grâce à l'en-tête Idempotency-Key. Elle s'appelle depuis tout outil capable d'envoyer une requête HTTPS : un CRM, un script interne, ou un outil d'automatisation comme Zapier ou Make. Chaque clé API reçoit seulement les droits nécessaires (lecture, création, modification, suppression, statistiques) ; elle ne s'affiche qu'une fois, puis peut être tournée ou révoquée à tout moment tant que votre compte est au plan Pro ou Entreprise. Le plan Pro comprend 5 créations de QR codes via l'API par mois civil et 1 clé active ; le plan Entreprise, 100 créations par mois civil et jusqu'à 10 clés actives simultanément. Seules ces créations sont décomptées : lire, modifier ou supprimer un QR code, ou en créer un dans le tableau de bord, ne l'est pas. Des packs de créations sont disponibles en option, avec un abonnement payant actif (voir les tarifs). Le plan Gratuit ne donne pas accès à l'API. La documentation de l'API décrit chaque endpoint et propose la spécification OpenAPI.

Écran des clés API dans QR Suisse : une clé avec ses droits, sa date de dernière utilisation et le quota de créations du mois — compte de démonstration, données fictives.
Des clés aux droits limités, à faire tourner ou à révoquer à tout moment (compte de démonstration, plan Pro).

Questions fréquentes

Quels plans donnent accès à l'API ?
Les plans Pro et Entreprise. Le plan Pro inclut 5 créations de QR codes via l'API par mois civil et 1 clé active. Le plan Entreprise en inclut 100, avec jusqu'à 10 clés actives simultanément. Le plan Gratuit ne donne pas accès à l'API.
Qu'est-ce qui est compté dans le quota ?
Uniquement la création de QR codes via l'API. Lire, modifier, archiver, réactiver, supprimer un QR code, télécharger son image ou lire ses statistiques n'est pas compté, pas plus qu'un QR code créé dans le tableau de bord. Une création reste comptée même si le QR code est supprimé ensuite. Le quota est remis à zéro le 1er de chaque mois à 00 h UTC (1 h ou 2 h en Suisse), sans report.
Où suivre les créations utilisées ce mois-ci ?
Dans l'écran Clés API du tableau de bord, accessible aux membres qui ont la permission « Gérant des clés API » (ou Administrateur). L'encart « Créations de QR codes via l'API ce mois-ci » indique les créations incluses déjà utilisées, les créations prélevées sur vos packs et celles qui restent dans vos packs, ainsi que la date de remise à zéro du quota. Via l'API, GET /usage renvoie les mêmes chiffres à une clé qui a le droit QR_CREATE.
Que se passe-t-il quand le quota est épuisé ?
Les créations utilisent vos packs de créations, s'il vous en reste. Sinon, la création est refusée (erreur 429 quota_exceeded) jusqu'à la remise à zéro du 1er du mois suivant, ou jusqu'à l'achat d'un pack. Rien n'est facturé à l'usage.
Puis-je archiver ou réactiver un QR code via l'API ?
Oui, un QR code à la fois : une modification avec active à false l'archive, avec true le réactive. Ce n'est pas compté dans le quota de créations. L'archivage garde le contenu et les statistiques. La suppression définitive, elle, est irréversible : le QR code et ses statistiques sont effacés, et son adresse ne pourra plus jamais servir.
L'API gère-t-elle les étiquettes, les actions groupées et les exports ?
Non. Les étiquettes, la sélection multiple, le téléchargement en ZIP et l'export CSV se font dans le tableau de bord, avec les plans Pro et Entreprise. Via l'API, vous lisez la liste de vos QR codes page par page, avec recherche (libellé, destination et fin de l'adresse courte), filtres (statut, type, période de création) et tri, mais sans filtre par étiquette, et vous téléchargez les images une par une.
Que faut-il faire dans le tableau de bord plutôt que via l'API ?
La configuration du compte : créer et gérer les clés API, inviter des membres et régler leurs permissions, configurer le domaine personnalisé, gérer l'abonnement et acheter des packs de créations. La documentation de l'API compare en détail ce que font l'API et le tableau de bord.
Puis-je connecter l'API à Zapier, Make ou un agent IA ?
Oui, à tout outil capable d'envoyer des requêtes HTTPS avec une clé. Il n'existe pas d'intégration officielle ni de connecteur dédié aux assistants IA (MCP) à ce jour. Un préréglage « Agent IA assistant » limite la clé à la lecture.
Comment protéger une clé API ?
Donnez-lui seulement les droits nécessaires, appelez toujours l'API en https://, et conservez la clé dans un gestionnaire de secrets : elle ne s'affiche qu'une fois. Si elle a pu être exposée, faites-la tourner ou révoquez-la depuis l'écran Clés API. Au plan Gratuit, où vos clés sont gelées et ne s'affichent pas, écrivez à contact@qrsuisse.ch depuis l'adresse e-mail d'un administrateur du compte.
Y a-t-il une limite au nombre d'appels ?
Oui, pour protéger le service : 30 requêtes par minute et par clé, dont 8 créations au maximum. Les images PNG sont en outre limitées à 10 par minute pour tout le compte. Au-delà, l'API répond 429 rate_limited avec le délai à attendre. Seule la création est en plus soumise au quota mensuel de créations.
Une création a été interrompue par une coupure réseau : comment la relancer sans doublon ?
Envoyez chaque création avec l'en-tête Idempotency-Key : une valeur aléatoire nouvelle par création (UUID v4 recommandé), sans donnée personnelle. Si la réponse n'arrive pas, renvoyez la même requête avec la même valeur dans les 24 heures : vous recevez le QR code déjà créé, sans second QR code ni seconde création décomptée du quota. Sans cet en-tête, vérifiez la liste de vos QR codes avant de relancer : une création aboutie reste comptée, même si vous supprimez ensuite le doublon.

Fiches d'aide

Essayer QR Suisse

Le plan Gratuit est disponible immédiatement en libre-service, sans carte bancaire.

Créer un compte gratuitDécouvrir le plan Pro