QR-Code-Generierung
Um einen Code zu generieren, müssen Sie die Funktion https://store.mavibot.ai/function/qrcode\\_generator verwenden.
Parameter:
text_for_qr - Text, der codiert werden soll
api_key - API-Zugriffsschlüssel aus den Projekteinstellungen
Ersetzen Sie #{api_key} durch den Token aus den Einstellungen
Beispiel:
Fügen Sie im Feld „URL-Anfrage“ ein: https://store.mavibot.ai/function/qrcode\\_generator
Fügen Sie im Feld „Gespeicherte Werte“ die Variablen ein, die Sie speichern möchten (die erforderliche URL befindet sich in qr_image_url):
status->status;
qr_image_url->qr_image_url
Geben Sie in „JSON-Parameter“ ein:
{"text_for_qr":"Text zum Codieren","api_key":"8629fe13ba9efebefd27a7afd701767f"}
Die Funktion gibt JSON mit den Parametern status und qr_image_url zurück.
Barcode-Generierung
Um einen Code zu generieren, müssen Sie die Funktion https://store.mavibot.ai/function/barcode\\_generator verwenden.
Parameter:
text_for_qr - Text, der codiert werden soll
api_key - API-Zugriffsschlüssel aus den Projekteinstellungen
class - die Code-Klasse, die Sie generieren möchten. Standardmäßig ist es ea13. Mögliche Werte: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'
without_text - (ein optionaler Parameter) Wenn Sie einen beliebigen Wert angeben, wird der Barcode ohne Text angezeigt, wie im Bild unten.
Ersetzen Sie #{api_key} durch den Token aus den Einstellungen
Beispiel: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}
Die Funktion gibt JSON mit den Parametern status und qr_image_url bei Erfolg und error_message bei Misserfolg zurück.
Der Beispieltext wird in der Variable barcode gespeichert, und die Variable image_url wird verwendet, um ihn als Bild zu senden.
Barcode-Erkennung aus einem Bild
Sie können dies verwenden, um einen Bot zu erstellen, der Produktcodes scannt. Eine nützliche Funktion ist, dass er auch QR-Codes scannen kann.
Die Adresse der Funktion, die einen Barcode auf einem Bild erkennt, ist https://store.mavibot.ai/function/cv2barcode.
Um ein Bild zu scannen, müssen Sie diese Parameter vom Block senden:
{"photo":"der Link zum Barcode/QR-Code oder die Variable mit dem Link","api_key":"API-Zugriffsschlüssel aus den Einstellungen"}
Um beispielsweise ein Bild zum Scannen zu senden, müssen Sie diese Parameter senden:
Geben Sie im Pfeil im Feld „Benutzer gibt Daten ein“ die Variable #{attachments} ein.
Codebeispiel:
{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}
photo ist der Link zum Barcode-Bild; in unserem Fall ist es die Variable, die den Link zum an den Bot gesendeten Bild enthält.
Der nächste Parameter ist api_key - API-Zugriffsschlüssel aus den Projekteinstellungen.
Die Funktion funktioniert wie folgt:
Der Client sendet ein Bild des Barcodes, die Funktion scannt es und gibt bei Erfolg die Barcode-Nummer mit dem Betriebsstatus „ok“ zurück.
barcode -> "4500000000567" status -> "ok"
Der Scan-Status kann sein:
- ok — der Barcode wurde erkannt
- barcode not recognized — wie der Name schon sagt, konnte der Barcode nicht erkannt werden
- error image reading — es gab einen Fehler beim Lesen des Bildes
- error subscription — diese Funktion ist mit Ihrem aktuellen Abonnement nicht verfügbar
Die Variable status kann als Bedingung für einen Pfeil verwendet werden, um den Client zum entsprechenden Block zu leiten.
Wenn beispielsweise die Bedingung eines Pfeils prüft, ob der Status gleich „barcode not recognized“ ist, können Sie die Nachricht „Der Code wurde nicht erkannt, bitte versuchen Sie es erneut“ anzeigen und den Client auffordern, das Foto erneut zu senden.