Créer des QR codes depuis un logiciel ou un agent IA
Avec un plan Pro ou Entreprise, QR Suisse, générateur de QR codes dynamiques édité par Skyday Sàrl, se pilote par une API REST : créer un QR code (lien ou carte de contact), changer sa destination, télécharger son image PNG ou SVG et lire ses statistiques. Un agent IA l'utilise avec une clé API que vous lui confiez par sa configuration. Pour apprendre l'API, l'agent peut se connecter au serveur MCP public de QR Suisse, qui donne accès à la documentation en lecture seule.
Ce que l'API permet
- Créer un QR code de type lien (URL) ou carte de contact (vCard), avec un libellé.
- Modifier sa destination après impression, l'archiver ou le réactiver.
- Télécharger son image en SVG (pour l'impression) ou en PNG.
- Lire le nombre de scans, au total et par jour.
- Appliquer un modèle de style déjà créé dans le tableau de bord.
- Lister et rechercher les QR codes du compte.
La documentation complète et la spécification OpenAPI sont publiques : https://www.qrsuisse.ch/openapi.json.
Trois étapes pour une intégration
- Créer une clé API dans le tableau de bord. Seul un membre qui a la permission « Gérant des clés API » (ou Administrateur) peut le faire, et il choisit les droits de la clé : créer, lire, modifier, supprimer, lire les statistiques.
- Donner la clé à votre programme ou à votre agent par sa configuration, par exemple une variable d'environnement. Ne la collez jamais dans une conversation.
- Appeler l'API en HTTPS, avec l'en-tête
Authorization: Bearer <clé>.
Un agent IA qui connaît la documentation : le serveur MCP
Le serveur MCP public de QR Suisse permet à un assistant compatible (Claude Code, Visual Studio Code et d'autres clients MCP) de chercher dans la documentation et d'en lire chaque page : guides, tarifs et une page par opération de l'API. Il a deux outils, en lecture seule : qr_suisse_search_docs et qr_suisse_get_page.
- Il n'a accès à aucun compte et ne crée aucun QR code.
- Il ne demande ni inscription ni clé.
- Il accepte 60 requêtes par minute et par adresse.
L'adresse et la configuration de chaque client se trouvent sur la page Serveur MCP.
Limites à connaître avant de commencer
- L'API est réservée aux plans Pro et Entreprise.
- Chaque plan permet un nombre de clés actives : 1 en Pro, 10 en Entreprise.
- Les créations par API sont limitées par mois civil : 5 en Pro, 100 en Entreprise, puis des packs de créations à l'achat unique. Modifier, lire ou télécharger un QR code ne consomme rien.
- La documentation pour agents est en anglais ; la spécification OpenAPI existe aussi en français.
Questions fréquentes
Un agent IA peut-il créer un QR code QR Suisse tout seul ?
Le serveur MCP donne-t-il accès à mes QR codes ?
L'API est-elle disponible avec le plan Gratuit ?
Peut-on modifier par l'API un QR code déjà imprimé ?
Autres cas d'utilisation
QR code statique ou dynamique : lequel choisir ?
Ce que permet chaque type, ce dont il dépend, et lequel choisir pour un support imprimé.
QR code pour carte de visite
Vos coordonnées restent à jour sur les cartes déjà imprimées.
QR codes pour flyers et affiches
Un QR code par version, corrigeable après impression, pour les agences et les imprimeurs.