Соответствие фото (селфи) и паспорта

• Описание
• Параметры запроса
• Структура отчёта

P.0067.IMG.SCN

Решение для сравнения фотографии человека и фотографии из паспорта.

Используется для удалённой идентификации человека (регистрация пользователей каршеринга и исполнителей различных работ, приём на работу в такси и транспортные компании, службы доставки и др.).

Считается, что на фотографиях изображен один и тот же человек, если лица совпадают на 20—100 %. Если совпадение лиц менее 20 %, то считается, что на фото изображены разные люди.

Идентификаторы объекта: фото (скан) паспорта и фото (селфи).

Фотографии можно передать одним из двумя способов: указав ссылку на фото на внешнем ресурсе или используя UID файла в хранилище сервиса (для этого изображение нужно предварительно загрузить в систему. Подробнее в разделе Управление файлами).

Требования к фото: максимальный размер — 30 Мбайт (15 Мбайт при загрузке файла в хранилище сервиса), минимальный размер — 1 Кбайт.

Иcпользуемые источники: check_person/face_match.

Время генерации отчёта:

• 50-й перцентиль — 2 с;
• 95-й перцентиль — 30 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Фото в запросе можно передавать двумя способами:

1. указать уникальный идентификатор файла в хранилище сервиса в параметре assets[].uid. В параметре assets[].destination_path требуется передать значение data.photo_url для фото физлица или data.passport_url для скана паспорта;
2. указать ссылки на фото в параметрах passport_url и photo_url.

Если фотография в запросе передана обоими способами, то будет использоваться файл, указанный в параметре assets[].uid.

Пример тела запроса с фото в хранилище сервиса

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "assets": [
      {
        "uid": "76532174196300087654321@test_domain",
        "destination_path": "data.passport_url"
      },
      {
        "uid": "237e9877e79b12d4a765321741963000@test_domain",
        "destination_path": "data.photo_url"
      }
    ]
  }
}

Пример тела запроса по фото с внешнего ресурса

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "passport_url": "https://some.domain/passport.png",
    "photo_url": "https://some.domain/photo.png"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.check_person.face_match тела ответа.

Справочник Статус сравнения фото

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "P.0067.IMG.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/face_match",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "face_match": {
            "status": "MATCH",
            "status_desc": "Лица совпадают",
            "match_percentage": 90.02
          }
        }
      }
    }
  ]
}

Пример данных отчёта, если на фото отсутствует лицо

{
  "data": [
    {
      "report_type_uid": "P.0067.IMG.SCN_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/face_match",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "face_match": {
            "status": "FACE_NOT_FOUND",
            "status_desc": "В одном из загруженных фото или в обоих отсутствует лицо"
          }
        }
      }
    }
  ]
}