QR-код и штрихкод: генерация и распознавание

Генерация QR-кода

Для генерации QR-кода необходимо воспользоваться функцией с адресом https://store.salebot.pro/function/qrcode_generator

Параметры:

text_for_qr - текст который нужно закодировать.

api_key - ключ API из настроек проекта

Пример:

В поле "URL запроса" пишем https://store.salebot.pro/function/qrcode_generator

В поле JSON параметры пишем:

{"text_for_qr":"Текст для кодирования","api_key":"c16ac0f344480f24541dd78f350297f471b5e25bd15e"}

В поле "Сохраняемые значения" пишем те переменные, которые хотим сохранить (нужный нам URL будет в qr_image_url):

status->status;

qr_image_url->qr_image_url

Ответ: функция возвращает json с параметрами status и qr_image_url

Генерация штрихкода

Чтобы сгенерировать штрихкод, необходимо воспользоваться функцией с адресом https://store.salebot.pro/function/barcode_generator

Параметры: text - текст который нужно закодировать. api_key - ключ апи из настроек проекта.

class - класс кода, который необходимо сгенерировать. По умолчанию ea13. Может принимать значения 'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'

without_text - необязательный параметр, если его передать с любым значением, на картинке штрихкод будет отображаться без текста или как на картинке ниже

Пример: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}

Ответ: функция возвращает json с параметрами status и image_url в случае успеха и error_message в случае неудачи.

В примере в переменной barcode лежит текст для кодирования и переменная image_url сразу отправляется в сообщении как картинка.

Распознавание на фотографии

Вы можете использовать ее для создания бота, который сканирует коды товаров. Полезной особенностью является то, что она также может сканировать QR-коды.

Функция для распознавания штрихкода на фотографии.

Адрес функции: https://store.salebot.pro/function/cv2barcode

Для сканирования фото вам необходимо отправить из блока следующие параметры:

{"photo":"ссылка на штрихкод/qr код или переменная со ссылкой","api_key":"апи ключ из настроек проекта"}

Например, для отправки на сканирование фото, отправленного боту, нужно отправить следующие параметры:

В стрелке -> в поле "Пользователь вводит данные" укажите название переменной attachments.

Пример кода:

{"photo":"#{attachments}","api_key":"eec62fb64bc0107a930ad3c60773b743b0bffa758981"}

Где photo это ссылка на фотографию штрихкода, в нашем случае это переменная содержащая ссылку на фото отправленное боту.

Следующий параметр api_key это ключ, который можно сгенерировать в настройках вашего проекта (Рисунок 2)

Функция работает следующим образом. Клиент отправляет боту фото штрихкода, функция пробует его распознать и в случае успеха присылает штрихкод в виде числа и статус операции равен ok:

barcode -> "4500000000567" status -> "ok"

Статус сканирования бывает следующим:

1. ok - штрихкод распознан

2. barcode not recognized - штрихкод не распознан

3. Error image reading - ошибка чтения файла

4. Error subscription - для вашей подписки не доступен данный функционал

Переменную status можно поставить в виде условия на стрелку и отправлять пользователя в соответствующий блок.

Например, если на стрелке условие перехода переменная “status” и значение “barcode not recognized”, тогда выводим сообщение “Код не распознан, повторите попытку” и отправляем на повторный запрос фото.