API V2
На этой странице представлена документация HTTP API V2 для использования visionbot.ru.
Получение доступных языков
Получить список всех доступных языков:
Адрес: https://visionbot.ru/apiv2/get_languages.php
Метод: GET
Параметры: нет.
В ответе будет JSON с полем languages, с массивом из двух буквенного обозначения языков.
Пример ответа:
{"languages":["af","am","zh"]}
Распознавание изображений
Параметры, такие как id, lang, target, qr, bm, translate, url можно передавать как GET, так и POST,
Для остальных рекомендован POST.
Для начала распознавания нужно загрузить изображение
на адрес: https://visionbot.ru/apiv2/in.php
одним способом из трёх:
- поле
fileметодmultipart/form-data - поле
body
с закодированным base64 содержимым изображения методом
application/x-www-form-urlencode; charset=utf-8 - поле
urlс прямой ссылкой на изображение
и передать дополнительные параметры:
- lang - STRING - язык по стандарту ISO 639-1, на данный момент поддерживается 95 языков (используется Яндекс Переводчик)
поумолчанию en
Примеры: ru, ua, be, uz, es, fr, pt - target - STRING - что распознавать
- all (поумолчанию) всё
- text только текст
- images только образы
- qr - INTEGER - читать QR/BAR коды? 0 нет (поумолчанию), 1 да
- bm - INTEGER - использовать ли Be My AI для распознавания? 0 нет (поумолчанию), 1 да
- translate - INTEGER - Переводить распознанный текст? 0 нет (поумолчанию), 1 да
В ответе вы получите JSON с двумя полями:
- status - STRING - ok или error
- id - STRING - ID для следующего запроса и получения результата
Для получения результата необходимо отправить запрос на адрес: https://visionbot.ru/apiv2/res.php
и передать параметр id из предыдущего запроса.
В ответе будет JSON с полями:
- status - STRING - ok, notready или error. Если notready, повторите этот же запрос через несколько секунд
- id - STRING - ID запроса (действителен один час или 3600 секунд)
- text - STRING - результат распознавания
- qr - STRING - QR/BAR код, поле возвращается только если запрашивалось, может быть пустой строкой, если его нет
