Utiliser une API REST pour générer des QR codes
Cette page se concentre sur l’intégration HTTP : endpoints, authentification, codes de réponse et stratégie de quota côté application.
Équipes techniques qui veulent appeler MassQR depuis Python, Node.js, PHP, Java, Go, un ERP ou une plateforme no-code capable d’émettre des requêtes HTTP.
- HTTP standard
- Bearer token
- Réponses SVG/PNG binaires
- ZIP pour les petits batches API
- Codes 401/402/413/422 explicites
Un processus clair de la donnée au fichier QR
1. Authentifier
Ajoutez Authorization: Bearer mqk_VOTRE_CLE.
2. Poster le payload
Envoyez le contenu QR et les options dans le corps JSON.
3. Lire les headers
Le solde restant est communiqué après les rendus.
4. Gérer les erreurs
Traitez 401 clé invalide, 402 quota insuffisant, 413 volume trop gros et 422 données invalides.
Principaux endpoints REST
Un exemple volontairement simple pour montrer comment les données restent liées au QR produit.
| Méthode | Route | But |
|---|---|---|
GET | /v1/customer/usage | Solde API |
POST | /v1/customer/qrcode.svg | Rendu SVG |
POST | /v1/customer/payload/compose | Composer Wi-Fi/vCard |
Concevoir une intégration robuste
Stockez la clé dans un secret serveur et prévoyez une rotation en cas d’exposition.
N’attendez pas d’atteindre zéro unité pour alerter votre équipe : surveillez le header de solde restant.
Pour des millions de QR, découpez les productions de manière adaptée à votre architecture plutôt que d’envoyer une requête HTTP énorme.
Questions fréquentes
Quel code HTTP indique un quota insuffisant ?
MassQR utilise HTTP 402 pour signaler que les unités API disponibles ne suffisent pas à la demande.
Peut-on composer un QR Wi-Fi sans connaître la syntaxe WIFI:?
Oui. L’endpoint de composition accepte des champs structurés et retourne le payload normalisé.