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

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

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

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

  1. Получите свой ключ лицензии у нашего менеджера. Если у вас его нет, напишите на hello@dbrain.io

  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-запрос можно преобразовать в нужный вам язык программирования с помощью онлайн-конвертеров, например curl.trillworks.com

  6. Используйте полученный код в качестве основы для создания собственной интеграции с Dbrain.

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

# Токен в заголовке, вариант №1
$ curl -siX POST \
    -H "Authorization: Token <API_TOKEN>" \
    -F "image=@document.jpg" \
    "https://latest.dbrain.io/<END_POINT>"

# Токен в заголовке, вариант №2
$ curl -siX POST \
    -H "Authorization: <API_TOKEN>" \
    -F "image=@document.jpg" \
    "https://latest.dbrain.io/<END_POINT>"

# Токен в параметрах запроса
$ curl -siX POST \
    -F "image=@document.jpg" \
    "https://latest.dbrain.io/<END_POINT>?token=<API_TOKEN>"

# Токен в кукис
$ curl -siX POST \
    -H "Cookie: token=<API_TOKEN>"
    -F "image=@document.jpg" \
    "https://latest.dbrain.io/<END_POINT>"

PreviousПодключение и тестированиеNextЛокальная установка

Last updated