Перейти к содержанию

Проверка селфи/фото на живость

Отправка документа

Структура запроса:

url: https://api.beorg.ru/api/bescan/add_document
method: POST
headers:
    Content-Type: application/json

body:
{
    "project_id": "U_RATE_2",
    "images": ["<строка base64>"],
    "process_info": [настройки обработки]
    "token": token,
    "machine_uid": machine_uid
}

Пример ответа об успешной загрузке:

{
    "document_id": "s-12345"
}

Структура передаваемых данных:

Ключ Описание
project_id название проекта
token токен доступа
machine_uid идентификатор устройства
images список из строк base64 (файлов)
process_info настройки обработки


Структура prosess_info:

Ключ Описание
key свободный ключ для разделения документов при загрузке и получении результатов
если не указан вместо него используется улюч type
type тип документа
options опции обработки документа


Структура process_info.options:

Ключ Описание
stages этапы обработки документа
(Доступны: verification, biometry_match, biometry_liveness)
relation связь с иным документом в одном запросе (Доступны: biometry_match)


Для получения token, machine_uid и project_id обратитесь в подраздел "Начало работы"

  • Python
  import requests
  import base64

  with open("<путь до файла фотографии(селфи)>", "rb") as image_file:
      b64_selfie = base64.b64encode(image_file.read()).decode()

  r = requests.post(
      "https://api.beorg.ru/api/bescan/add_document",
      headers={"Content-Type": "application/json"},
      json={
          "project_id": project_id,
          "token": token,
          "machine_uid": machine_uid,
          "images": [b64_selfie],
          "process_info": [
              {
              "key": "SELFIE1",
              "type": "SELFIE",
              "options": {
                  "stages": [
                  "biometry_liveness"
                  ]
              }
              }
          ]
      },
  )
  r.json()