QR-код и штрихкод: генерация и распознавание
Генерация QR-кода
Чтобы сгенерировать код, вам нужно использовать функцию https://store.mavibot.ai/function/qrcode_generator
Параметры:
text_for_qr - текст, который нужно закодировать api_key - ключ доступа API из настроек проекта
Замените #{api_key} на токен из настроек
Пример:
В поле «URL request» вставьте: https://store.mavibot.ai/function/qrcode_generator
В поле «Stored values» вставьте переменные, которые хотите сохранить (нужный URL находится в qr_image_url):
status->status;
qr_image_url->qr_image_url
В «JSON parameters» введите
{"text_for_qr":"Текст для кодирования","api_key":"8629fe13ba9efebefd27a7afd701767f"}
Функция возвращает json с параметрами status и qr_image_url
Генерация штрих-кода
Чтобы сгенерировать код, вам нужно использовать функцию https://store.mavibot.ai/function/barcode_generator
Параметры:
text_for_qr - текст, который нужно закодировать api_key - ключ доступа API из настроек проекта
class - класс кода, который нужно сгенерировать. По умолчанию это ea13. Может принимать такие значения: 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'
without_text - (необязательный параметр) если вы передадите любое значение, штрих-код будет отображаться без текста, как показано на изображении ниже.
Замените #{api_key} на токен из настроек
Пример: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}
Функция возвращает json с параметрами status и qr_image_url если успешно и error_message если неуспешно
Текст примера хранится в переменной barcode, а переменная image_url используется для отправки его в виде изображения.
Распознавание штрих-кода по изображению
Это можно использовать для создания бота, который сканирует коды товаров. Полезная особенность заключается в том, что он также может сканировать QR-коды.
Адрес функции, которая распознает штрих-код на изображении: https://store.mavibot.ai/function/cv2barcode
Чтобы отсканировать изображение, вам нужно отправить эти параметры из блока:
{"photo":"ссылка на штрих-код/QR-код или переменная со ссылкой","api_key":"ключ доступа API из настроек"}
Например, чтобы отправить изображение на сканирование, вам нужно передать эти параметры:
В стрелке в поле «User enters data» введите переменную #{attachments}.
Пример кода:
{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}
photo — это ссылка на изображение штрих-кода; в нашем случае это переменная, которая содержит ссылку на изображение, отправленное боту.
Следующий параметр — api_key - ключ доступа API из настроек проекта
Функция работает так:
Клиент отправляет изображение штрих-кода, функция сканирует его и, если успешно, возвращает номер штрих-кода со статусом операции, установленным в «ok».
barcode -> "4500000000567" status -> "ok"
Статус сканирования может быть таким:
ok — штрих-код распознан
штрих-код не распознан — как следует из названия, штрих-код не удалось распознать
ошибка чтения изображения — произошла ошибка при чтении изображения
ошибка подписки — эта функция недоступна в вашем текущем тарифном плане
Переменную status можно использовать как условие на стрелке, чтобы направить клиента в нужный блок.
Например, если условие стрелки проверяет, равно ли status значению «штрих-код не распознан», вы можете показать сообщение «Код не был распознан, попробуйте еще раз» и попросить клиента отправить фотографию еще раз.
Последнее обновление