Подключение к облаку

Dbrain — серверное решение. Если вы хотите его протестировать, воспользуйтесь веб-демо. Мы не используем долговременного хранилища данных, все входящие файлы передаются на сервер по защищённому протоколу, обрабатываются в оперативной памяти и удаляются сразу после возврата результатов пользователю. В тестовых целях пригодится паспорт России из Википедии.

Для настройки использования облачного API необходимо составить корректный запрос необходимого API-метода. Для этого сперва ознакомьтесь с описанием нужного вам сервиса и его API-спецификацией. После этого перейдите к составлению нужного запроса:

Последовательность действий для получения корректного запроса

  1. Получите свой ключ лицензии у нашего менеджера. Если у вас его нет, напишите на [email protected]

  2. Найдите изображение тестового документа. В тестовых целях можно использовать паспорт России из Википедии.

  3. Постройте запрос с помощью Swagger UI по адресу latest.dbrain.io/try:

    1. Нажмите на Authorize в правом верхнем углу страницы и введите в любое поле Value ваш ключ лицензии;

    2. Выберите необходимый API-метод. Например, если вам нужно распознать поля паспорта, выберите метод /recognize;

    3. Нажмите кнопку Try it out;

    4. Выберите необходимые значения параметров API-запроса. Если параметр optional, то можно не выбирать его значение, оно будет по умолчанию;

    5. прокрутите вниз до большой синей кнопки «Execute», нажмите Выбрать файл напротив надписи image, в случае с паспортом из Википедии — файл Pasport_RF.jpg;

    6. нажмите Execute.

  4. В поле curl вы получите готовый корректный curl-запрос. Скопируйте его в буфер обмена.

  5. Чтобы проверить curl запрос, воспользуйтесь консолью, например PowerShell. Для этого перейдите в директорию, в которой лежит файл, выбранный на этапе 3.5. Например: cd C:\Downloads. Вставьте curl-запрос из буфера обмена и выполните его.

Curl-запрос можно преобразовать в нужный вам язык программирования с помощью онлайн-конвертеров, например curl.trillworks.com

Запрос к облаку обязательно должен включать в себя ключ лицензии API_TOKEN. Варианты его передачи представлены ниже (под END_POINT понимается метод, например, "recognize")

# Токен в заголовке, вариант №1
$ curl -siX POST \
-H "Authorization: Token <API_TOKEN>" \
"https://latest.dbrain.io/<END_POINT>"
# Токен в заголовке, вариант №2
$ curl -siX POST \
-H "Authorization: <API_TOKEN>" \
"https://latest.dbrain.io/<END_POINT>"
# Токен в параметрах запроса
$ curl -siX POST \
"https://latest.dbrain.io/<END_POINT>?token=<API_TOKEN>"
# Токен в кукис
$ curl -siX POST \
-H "Cookie: token=<API_TOKEN>"
"https://latest.dbrain.io/<END_POINT>"