API QR code
L’API QR Code Crafter crée des fichiers QR statiques via un point de terminaison public Netlify Function. Elle convient aux outils internes, agents IA, modèles de campagne, catalogues produits et flux de travail qui génèrent des fichiers QR à partir de données structurées.
Elle peut encoder des URL, Wi-Fi, vCard, événements, emplacements, charges utiles de paiement, liens de boutique d’apps, profils sociaux et textes simples. Le résultat est un fichier QR téléchargeable, pas une redirection dynamique obligatoire.
Les agents peuvent découvrir le contrat avec OpenAPI, WebMCP, ai.txt, llms.txt et les outils d’exécution publiés sur les pages actives. Cela évite de deviner les paramètres ou de lire visuellement les formulaires.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
Pour un fichier unique, appelez /.netlify/functions/generate-qr en GET ou POST. POST JSON est préférable pour les URL longues, vCard, événements, Wi-Fi, logos et flux qui doivent vérifier les métadonnées du fichier.
Pour plusieurs fichiers, appelez /.netlify/functions/generate-qr-bulk avec CSV ou objets de ligne JSON. Le point de terminaison retourne un ZIP avec les fichiers QR, manifest.csv et manifest.json, dans une limite publique de 50 lignes par requête.
Vérification indépendante des fonctionnalités
Vérifié le
Décisions clés
Point de terminaison QR unique
Une requête GET avec paramètres ou POST JSON vers generate-qr crée un fichier QR. La réponse POST inclut base64 data, filename, content type, extension, width, height et unit.
Découverte lisible par agents
/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt et /llms.txt décrivent les schémas, limites, formats et exemples de requêtes.
Six formats d’export
La même requête peut produire SVG, PNG, JPG, WebP, PDF ou EPS. Utilisez SVG/PDF/EPS pour impression et design, PNG/WebP pour publication digitale.
Flux de génération QR par lot
Le point de terminaison en lot traite jusqu’à 50 lignes et renvoie une archive ZIP avec fichiers QR et manifestes lisibles par machine.
Modèle statique sans dépendance inutile
La charge utile est inscrite dans le motif QR. Le scan ne dépend pas d’un compte fournisseur, d’un abonnement actif, d’un quota de scans ou d’une redirection hébergée.
Métadonnées vérifiables
Un agent peut contrôler byteLength, dimensions, extension, contentType, fileCount et manifest avant d’envoyer les fichiers vers CMS, Drive, imprimeur ou autre outil.
Options de requête pour l’API QR code
| Option | Valeur acceptée | Usage |
|---|---|---|
| Point de terminaison individuel | GET ou POST /.netlify/functions/generate-qr | Crée un fichier QR statique depuis la charge utile finale. |
| Point de terminaison en lot | POST /.netlify/functions/generate-qr-bulk | Crée un ZIP depuis des lignes CSV ou des objets de ligne JSON. |
| Limite du lot | 1-50 lignes par requête | Garde les automatisations publiques et agents dans un périmètre borné. |
| format | svg, png, jpg, webp, pdf, eps | Choisit le type de fichier pour web, documents, design ou impression. |
| size | 256-4096 | Définit les dimensions des images matricielles et exports de mise en page. |
| errorCorrectionLevel | L, M, Q, H | Choisissez H pour logo, impression ou contexte de scan plus difficile. |
| Métadonnées de réponse | contentType, extension, byteLength, width, height, unit | Confirme que le fichier enregistré correspond à la requête. |
| Fichiers de découverte | OpenAPI, WebMCP, ai.txt, llms.txt | Aide agents et clients API à lire les paramètres actuels sans deviner. |
| Mesure de campagne | Encoder une URL UTM ou une redirection propriétaire | Un QR statique ne crée pas de tableau de bord fournisseur; la mesure vient du flux de destination. |
Comment les agents doivent appeler l’API QR code
Un flux fiable commence par les fichiers de découverte, construit la charge utile finale, choisit le format et valide les métadonnées avant la remise.
Commencer par la découverte
Lisez /ai.txt, /llms.txt ou /.well-known/openapi.json pour utiliser le point de terminaison, le schéma, les exemples et les formats supportés actuels.
Utiliser POST pour l’automatisation
POST JSON évite les limites de chaîne de requête pour URL longues, vCard, événements, Wi-Fi, charges utiles de paiement et logos en URL de données.
Utiliser GET pour le téléchargement direct
GET retourne directement le fichier binaire et expose les headers X-QR-Width, X-QR-Height, X-QR-Unit et X-QR-Bytes.
Valider le fichier enregistré
Vérifiez contentType, extension, byteLength, width, height et unit avant d’envoyer le fichier vers CMS, Google Drive, imprimeur ou autre agent.
Flux de génération QR par lot
La génération en lot convient aux étiquettes, supports pédagogiques, emballages, menus, badges événementiels, variantes de campagne et fichiers QR créés depuis des données structurées.
Envoyer CSV ou objets de ligne
Utilisez CSV filename,value ou des lignes JSON avec value et filename optionnel. Les lignes vides, noms risqués et charges utiles trop volumineuses sont refusés.
Choisir un format commun
Définissez SVG, PNG, JPG, WebP, PDF ou EPS pour tout le lot. SVG convient au volume automatisé; PDF ou EPS à la remise imprimeur.
Demander ZIP si une archive est nécessaire
Accept: application/zip retourne un ZIP binaire. La réponse JSON reste disponible si l’agent doit lire des données ZIP en base64, byteLength, fileCount et manifest.
Utiliser le manifest pour l’audit
manifest.csv et manifest.json relient chaque ligne source à filename, status et au nombre d’octets pour tracer le résultat dans le système suivant.
Charges utiles statiques prises en charge
L’API encode exactement la charge utile envoyée. Validez la chaîne finale dans votre propre flux avant de générer et publier le fichier QR.
Liens marketing et contenus
Encodez URL HTTPS, URL UTM, pages de boutique d’apps, profils sociaux, menus, landing pages PDF, liens d’avis Google et redirections propriétaires.
Actions appareil
Encodez chaînes Wi-Fi, liens mailto, actions SMS, liens d’appel, liens WhatsApp, événements calendrier, coordonnées cartographiques et contacts vCard.
Charges utiles de paiement
Encodez SEPA, Swiss QR bill, PIX EMV, UPI URI, liens Swish et URI de portefeuille crypto après validation du bénéficiaire, montant, mémo et devise.
Design et impression
Utilisez SVG, PDF ou EPS pour les fichiers de production; PNG, JPG ou WebP pour aperçu, documents, email et publication web.
Checklist d’intégration agent
- Lire /ai.txt ou /.well-known/openapi.json avant de construire la requête.
- Utiliser POST JSON pour vCard, événement, Wi-Fi, paiement, logo et charges utiles longues.
- Limiter le point de terminaison en lot aux lots de 50 lignes maximum.
- Envoyer Accept: application/zip lorsque l’agent a besoin du ZIP binaire direct.
- Définir un User-Agent explicite pour les intégrations automatisées.
- Respecter Retry-After dans les réponses 429 et 503.
- Décoder les données base64 depuis la réponse POST et enregistrer avec l’extension retournée.
- Valider byteLength, dimensions, fileCount et les métadonnées de manifest avant la remise.
- Faire un test de scan pour chaque type de contenu et format exporté avant production.
- Pour la mesure, créer l’URL UTM ou la redirection propriétaire avant de générer le QR.
Guides: impression
API QR code doit être traité comme un processus de publication, et non comme une simple image générée. Vérifiez la destination, choisissez le format d’exportation, testez le fichier final et attribuez un responsable avant que le code apparaisse dans un support public.
Avant d’utiliser API QR code dans des documents imprimés, emballages, panneaux, e-mails, documents, applications ou automatisations, conservez une courte note de publication avec la valeur encodée, le nom du fichier, le format d’exportation, l’emplacement, le responsable et le résultat du test. Cette trace permet les corrections ultérieures.
QR code URL: HTTPS
Pour API QR code, vérifiez que l’URL encodée, les coordonnées, l’instruction de paiement, le fichier ou l’action de l’application sont exacts, contrôlés par la bonne équipe, disponibles sur mobile et adaptés aux personnes susceptibles de scanner le code.
Sélectionner le format
Conservez des fichiers maîtres SVG, PDF ou EPS pour l’impression, les emballages, les panneaux et les outils de création. Utilisez PNG, JPG, WebP ou SVG pour les sites web, les e-mails, les documents et les emplacements numériques, sans compresser le code final de manière inattendue.
scan
Avant la publication, scannez l’aperçu dans le navigateur, le fichier téléchargé, la mise en page intégrée, le PDF exporté, l’envoi dans le CMS, l’aperçu de l’e-mail et l’épreuve physique dans des conditions réalistes de distance, d’angle, de luminosité et d’appareil.
Entreprise
Enregistrez le responsable du QR, la destination, le fichier source, le format d’exportation, l’emplacement, la date de publication, les appareils de test, la date de contrôle et le déclencheur de remplacement afin que les codes QR statiques de longue durée restent fiables.
API QR code
Lorsque de nombreux fichiers QR sont nécessaires, utilisez des noms cohérents, des contrôles de manifeste, des paramètres OpenAPI ou WebMCP et une validation des formats de sortie avant de remettre les fichiers aux équipes de conception, d’impression ou de contenu.
QR codes statiques ou dynamiques
Revoyez API QR code après des changements de campagne, de marque, de domaine, de données de paiement, de boutique d’applications, de migration de documents ou d’analytique afin que les codes QR publics ne conduisent pas vers des destinations obsolètes ou dangereuses.
Avis
Ajoutez un texte de destination lisible, une URL courte, un contact d’assistance ou une instruction imprimée lorsque le scan est indispensable à l’activité, sensible pour l’accessibilité ou susceptible d’avoir lieu avec une connexion limitée.
Accessibilité
Placez près du code un texte qui explique l’action de scanner, conservez un contraste élevé, évitez les emplacements trop petits et assurez-vous que la destination fonctionne avec les navigateurs mobiles, les lecteurs d’écran, les réglages de mouvement réduit et la navigation au clavier.
Générer des QR codes via API
- 1
Choisir individuel ou lot
Utilisez generate-qr pour un fichier, ou generate-qr-bulk pour un ZIP avec plusieurs QR codes statiques.
- 2
Construire la charge utile finale
Préparez URL, chaîne Wi-Fi, vCard, événement, URI de paiement, texte, CSV ou objets de ligne exactement comme le lecteur doit les interpréter.
- 3
Choisir le format de sortie
Utilisez SVG/PDF/EPS pour impression et design; PNG/JPG/WebP pour publication digitale et aperçu.
- 4
Vérifier la réponse
Confirmez success, content type, byte length, dimensions, extension et manifest ZIP avant d’enregistrer les fichiers.
- 5
Tester dans le contexte final
Scannez le fichier après insertion dans la mise en page, le CMS, le document ou le BAT imprimé pour vérifier que le fichier automatisé fonctionne réellement.
Questions fréquentes
Quel est le point de terminaison de l’API QR Code Crafter ?
Utilisez /.netlify/functions/generate-qr avec des paramètres GET ou un corps POST JSON pour un QR code. Pour un ZIP en lot, utilisez /.netlify/functions/generate-qr-bulk.
L’API peut-elle générer des QR codes en lot ?
Oui. Envoyez des lignes CSV ou des objets de ligne JSON au point de terminaison en lot. La réponse peut être JSON avec des données ZIP en base64 ou directement application/zip si la requête utilise Accept: application/zip.
Faut-il un compte pour utiliser l’API ?
La génération publique est disponible sans compte tant que le déploiement n’active pas la vérification de clé API. Si une clé est fournie, envoyez X-Agent-Api-Key et gérez les réponses 401.
Quels formats de fichier l’API retourne-t-elle ?
Le contrat public supporte SVG, PNG, JPG, WebP, PDF et EPS.
Les agents de navigateur peuvent-ils utiliser WebMCP ?
WebMCP est une proposition de standard qui fonctionne uniquement dans un onglet visible ou une vue web compatible. Vérifiez les outils generate_qr et generate_bulk_qr enregistrés dans la page active : un manifeste seul ne permet pas de les appeler. Les clients sans interface et côté serveur doivent utiliser les points d’accès HTTP documentés par OpenAPI.
L’API crée-t-elle des QR codes dynamiques avec mesure ?
Non. L’API crée des fichiers QR statiques. Pour mesurer une campagne, encodez une URL UTM ou une redirection propriétaire avant de générer le QR code.
API QR code: QR code generator API?
API QR code: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.