Code QR et code-barres : génération et reconnaissance
Génération de code QR
Pour générer un code, vous devez utiliser la fonction https://store.mavibot.ai/function/qrcode_generator
Paramètres :
text_for_qr - texte qui doit être encodé api_key - clé d’accès API des paramètres du projet
Remplacez #{api_key} par le jeton des paramètres
Exemple :
Dans le champ « URL request », collez : https://store.mavibot.ai/function/qrcode_generator
Dans le champ « Stored values », collez les variables que vous souhaitez enregistrer (l’URL requise se trouve dans qr_image_url):
status->status;
qr_image_url->qr_image_url
Dans « JSON parameters », saisissez
{"text_for_qr":"Texte à coder","api_key":"8629fe13ba9efebefd27a7afd701767f"}
La fonction renvoie du json avec les paramètres status et qr_image_url
Génération de code-barres
Pour générer un code, vous devez utiliser la fonction https://store.mavibot.ai/function/barcode_generator
Paramètres :
text_for_qr - texte qui doit être encodé api_key - clé d’accès API des paramètres du projet
classe - la classe de code que vous devez générer. Par défaut, c’est ea13. Peut prendre les valeurs suivantes : 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'
sans_texte - (paramètre facultatif) si vous lui attribuez une quelconque valeur, le code-barres sera affiché sans le texte, comme indiqué dans l’image ci-dessous.
Remplacez #{api_key} par le jeton des paramètres
Exemple : {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}
La fonction renvoie du json avec les paramètres status et qr_image_url si réussi et message_d_erreur si infructueux
Le texte d’exemple est stocké dans la variable barcode, et la variable image_url est utilisée pour l’envoyer sous forme d’image.
Reconnaissance de code-barres à partir d’une image
Vous pouvez l’utiliser pour créer un bot qui scanne les codes produits. Une fonctionnalité utile est qu’il peut aussi scanner des codes QR.
L’adresse de la fonction qui reconnaît un code-barres sur une image est https://store.mavibot.ai/function/cv2barcode
Pour scanner une image, vous devez envoyer ces paramètres depuis le bloc :
{"photo":"le lien vers le code-barres/code QR ou la variable contenant le lien","api_key":"clé d’accès API des paramètres"}
Par exemple, pour envoyer une image à scanner, vous devez envoyer ces paramètres :
Dans la flèche du champ « User enters data », saisissez la variable #{attachments}.
Exemple de code :
{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}
photo est le lien vers l’image du code-barres ; dans notre cas, c’est la variable qui contient le lien vers l’image envoyée au bot.
Le paramètre suivant est api_key - clé d’accès API des paramètres du projet
La fonction fonctionne comme suit :
Le client envoie une image du code-barres, la fonction la scanne et, en cas de succès, renvoie le numéro du code-barres avec l’état de l’opération défini sur « ok ».
barcode -> "4500000000567" status -> "ok"
L’état du scan peut être :
'ok' — le code-barres a été reconnu
code-barres non reconnu — comme son nom l’indique, le code-barres n’a pas pu être reconnu
erreur de lecture de l’image — il y a eu une erreur lors de la lecture de l’image
erreur d’abonnement — cette fonctionnalité n’est pas disponible avec votre offre d’abonnement actuelle
La variable status peut être utilisée comme condition sur une flèche pour diriger le client vers le bloc approprié.
Par exemple, si la condition d’une flèche vérifie si status est égal à « code-barres non reconnu », vous pouvez afficher le message « Le code n’a pas été reconnu, veuillez réessayer » et inviter le client à renvoyer la photo.
Mis à jour