Aller au contenu

Créez des QR codes statiques avec une API publique

Guide API QR Code Crafter pour agents, outils internes et flux de travail en lot avec OpenAPI, WebMCP, ai.txt, génération ZIP et exports SVG, PNG, JPG, WebP, PDF, EPS.

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.

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

OptionValeur acceptéeUsage
Point de terminaison individuelGET ou POST /.netlify/functions/generate-qrCrée un fichier QR statique depuis la charge utile finale.
Point de terminaison en lotPOST /.netlify/functions/generate-qr-bulkCrée un ZIP depuis des lignes CSV ou des objets de ligne JSON.
Limite du lot1-50 lignes par requêteGarde les automatisations publiques et agents dans un périmètre borné.
formatsvg, png, jpg, webp, pdf, epsChoisit le type de fichier pour web, documents, design ou impression.
size256-4096Définit les dimensions des images matricielles et exports de mise en page.
errorCorrectionLevelL, M, Q, HChoisissez H pour logo, impression ou contexte de scan plus difficile.
Métadonnées de réponsecontentType, extension, byteLength, width, height, unitConfirme que le fichier enregistré correspond à la requête.
Fichiers de découverteOpenAPI, WebMCP, ai.txt, llms.txtAide agents et clients API à lire les paramètres actuels sans deviner.
Mesure de campagneEncoder une URL UTM ou une redirection propriétaireUn 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

Créez des QR codes statiques avec une API publique. QR code statique. Télécharger SVG, PNG, JPG, WebP, PDF, EPS. scan. checklists de prépresse QR. Aperçu en direct. Personnaliser QR code. Sans compte. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.

Créez des QR codes statiques avec une API publique. QR code URL. Création dans le navigateur. impression. usage numérique. Accessibilité. sécurité et confidentialité des QR codes. formats de fichier QR. scanner de QR codes. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.

QR code URL: HTTPS

Créez des QR codes statiques avec une API publique: QR code URL, Création dans le navigateur, HTTPS, scan. QR code statique. Liens prêts pour analytics. UTM. sécurité et confidentialité des QR codes.

Sélectionner le format

impression: SVG, PDF, EPS. usage numérique: PNG, JPG, WebP, SVG. formats de fichier QR. Télécharger. Exports vectoriels. Sélectionner le format.

scan

scan. Aperçu en direct. scanner de QR codes. checklists de prépresse QR. impression. usage numérique. Personnaliser. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.

Entreprise

Créez des QR codes statiques avec une API publique: QR code URL, Télécharger, SVG, PNG, JPG, WebP, PDF, EPS, impression, usage numérique, scan. Entreprise. Guides. Avis.

API QR code

API QR code. OpenAPI. WebMCP. ai.txt. llms.txt. flux de QR codes en lot. Télécharger SVG, PNG, JPG, WebP, PDF, EPS. QR code statique.

QR codes statiques ou dynamiques

Créez des QR codes statiques avec une API publique. QR code statique. Sans limite de scans. QR code URL. Liens prêts pour analytics. sécurité et confidentialité des QR codes. Création dans le navigateur. scan.

Avis

QR code URL. QR code appel. QR code email. Accessibilité. scan. Avis. QR code SMS.

Accessibilité

Accessibilité. scan. impression. usage numérique. QR code URL. Création dans le navigateur. Aperçu en direct.

Générer des QR codes via API

  1. 1

    Choisir individuel ou lot

    Utilisez generate-qr pour un fichier, ou generate-qr-bulk pour un ZIP avec plusieurs QR codes statiques.

  2. 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. 3

    Choisir le format de sortie

    Utilisez SVG/PDF/EPS pour impression et design; PNG/JPG/WebP pour publication digitale et aperçu.

  4. 4

    Vérifier la réponse

    Confirmez success, content type, byte length, dimensions, extension et manifest ZIP avant d’enregistrer les fichiers.

  5. 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 ?

Oui. Les pages actives enregistrent les outils generate_qr et generate_bulk_qr lorsque modelContext est disponible et exposent un balisage déclaratif de formulaire pour les lecteurs qui lisent les attributs toolname.

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.