Guides pratiques Qivo
Comment fonctionne une API de génération de code QR
Une API vous permet de générer des codes QR automatiquement de votre site Web, outil interne ou script.
Votre application envoie du contenu et des paramètres; Qivo retourne une image QR statique.
De l’éditeur à l’intégration
Dans l'éditeur, une personne remplit les champs et clique sur le téléchargement. Avec une API, un programme effectue ces actions, par exemple, en générant un code QR de la page de produit tout en préparant un étiquette.
Un appel API ne rend pas le code dynamique. l'image stocke les données soumises plutôt qu'une URL Qivo intermédiaire. vous pouvez enregistrer et utiliser le fichier sans contacter le générateur à nouveau.
Ce qu’une demande contient
Une demande GET contient l'adresse du service, les paramètres et une clé secrète. le contenuType paramètre sélectionne le type de données, le format sélectionne PNG ou SVG, et la forme, la frontière et le centre contrôle le design.
Les valeurs de paramètre doivent être codées par URL. Utilisez les outils standard de votre langue pour gérer correctement les espaces, les + dans les numéros de téléphone et les # dans les couleurs. Les champs invalides ou manquants causent une réponse d'erreur.
Pourquoi la clé appartient à votre serveur
Les visiteurs peuvent lire une clé placée dans le JavaScript d'une page publique.Envoyer des demandes de votre serveur et charger la clé d'une variable environnementale.
Envoyez la clé dans le titre X-API-clé sur HTTPS. Le paramètre d'URL clé est également supporté, mais les URL peuvent apparaître dans l'histoire et les journaux. Ne jamais mettre votre clé secret dans l'image QR ou les exemples publics.
Comment gérer la réponse
Une réponse réussie contient l'image elle-même, pas JSON avec un lien de téléchargement. Vérifiez l'état HTTP avant de sauvegarder. Erreurs retourner JSON avec une explication; ne le sauvegardez pas en tant que PNG.
SVG est utile pour les matériaux imprimés, tandis que PNG suit les images quotidiennes. Évitez de régénérer un code à chaque visite d'une page inchangée: sauvegarder et réutiliser le fichier. Respecter les limites de demande et le retard après retrait.
Que vérifier avant de publier
L'API valide l'entrée mais ne décode pas l'image terminée. Cela réduit le traitement, mais votre flux de travail doit gérer les tests de scan. Testez les combinaisons typiques de conception et les plus grands volumes de données que vous attendez.
Laissez une zone calme légère d'au moins quatre modules, un bon contraste et une taille suffisante. Scanner le layout imprimé final avec un téléphone. La page API contient des paramètres techniques et des exemples prêts à utiliser PHP, JavaScript, Python et cURL.
Sources et lectures complémentaires
Préparé et maintenu par Umind. Testez ces conseils sur votre mise en page et vos appareils cibles.