Перейти к основному содержанию
POST
Проверяет входные данные по базе данных государственного органа, которая содержит данные национальных удостоверений личности граждан. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с первоисточником и получить нормализованные результаты сопоставления.

Покрытие

  • Покрытие: ~ 80%
  • Страна: Камбоджа
  • Идентификатор сервиса: khm_national_id
  • Домен данных: Личность
  • Категория: NationalIDRegistry

Входные данные

  • Обязательные входные данные: first_name, last_name, date_of_birth, voter_id
  • Необязательные входные данные: gender, address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Согласие: обязательно
  • Доступность в сценарии: доступно в сценарии
  • Покрытие: ~ 80%
  • Цена: $0.59 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка записывается как не применимо: база данных не запрашивается, и с вас не взимается плата. Для некоторых стран такие пользователи составляют значительную долю. Чтобы охватить и их, также собирайте идентификатор из ответа на анкету, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставляйте его на шаге «Проверка по базам данных».

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

string
по умолчанию:"KHM"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: KHM
string
по умолчанию:"khm_national_id"
обязательно
Массив, содержащий идентификатор этого сервиса. Закрепление сервиса ограничивает запрос этой конкретной базой данных.Пример: khm_national_id
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"John"
обязательно
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия, которую нужно проверить.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"12345678"
обязательно
Идентификатор избирателя.Пример: 12345678
string
Значение пола, когда оно требуется базой данных.Допустимые значения: M (мужской), F (женский), X (другое или неизвестное).Пример: M
object
Структурированный объект адреса места жительства. Используйте street_1, street_2, city, region, postal_code и country. Полная строка адреса в старом формате по-прежнему принимается, но не рекомендуется.Пример: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого человека в вашей системе, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать шум при обнаружении дубликатов.Пример: user-1234

Правила ввода и примечания по валидации

  • address для этого сервиса необязателен. Вы можете отправить одну полную строку address, и Didit по возможности разобьёт её на структурированные элементы адреса, либо можете явно передать структурированные поля.
  • voter_id должен соответствовать шаблону (?:\d{8,9}|\d{2}-\d{3}-\d{3}).
  • Для сервисов, работающих с адресами, по возможности передавайте структурированные поля адреса вместо одной строки address.
  • address.street_1 - это адрес улицы, включая номер дома и тип улицы.
  • address.street_2 - это квартира, помещение, корпус, этаж или дополнительная строка адреса. Передавайте её, только если она у вас есть.
  • address.city - это город, пригород, район, населённый пункт или микрорайон.
  • address.region - это штат, провинция, регион или населённый пункт.
  • address.postal_code - это почтовый индекс.
  • Сервисы проверки по базам данных, работающие с адресами, требуют как минимум адрес улицы и почтовый индекс. Запросы, отклонённые до обращения к источнику данных, не тарифицируются.

Как выполнить запрос

Возвращаемые данные

Точный набор полей, который выводится в source_data, зависит от того, что возвращает реестр. Сгенерированный пример для khm_national_id сейчас описывает такую нормализованную структуру:
  • address
  • address_match_score
  • building_number
  • city
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score
  • state
  • street

Цены и SLA

Запросы по национальному удостоверению личности Камбоджи тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.
  • Цена за запрос: $0.59 USD.
  • Тарификация: за каждый успешный запрос. Плата не взимается, если реестр недоступен, если не заполнены обязательные поля или если запрос отклонён до передачи в источник.
  • Задержка: типичная задержка p95 < 2 с.
  • Доступность: 99.9% за квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.

Что почитать дальше

Последнее изменение 7 ноября 2026 г.