Перейти к основному содержанию
POST
Проверяет введённые данные по официальному сервису данных в Китае. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с первоисточником и получить нормализованные результаты сопоставления. Формат ввода: date_of_birth принимает дату рождения, которая должна совпадать с датой, закодированной в китайском национальном идентификационном номере (цифры 7–14 из 18-значного номера или цифры 7–12 из устаревшего 15-значного).

Покрытие

  • Покрытие: ~ 100%
  • Страна: Китай
  • Service ID: chn_national_id
  • Домен данных: Identity
  • Категория: NationalIDRegistry

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

  • Обязательные входные данные: full_name, date_of_birth, national_id
  • Необязательные входные данные: vendor_data
  • Согласие: обязательно
  • Доступность в сценарии: доступно в сценарии
  • Покрытие: ~ 100%
  • Цена: $0.50 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как неприменимо: база данных не запрашивается, и с вас не взимается плата. В некоторых странах такие пользователи составляют значительную долю реальных пользователей. Чтобы охватить их, также собирайте идентификатор из ответа на анкету, поля извлечения Document AI или значения, которое вы передаёте при создании сессии, и сопоставьте его с шагом «Проверка по базам данных».

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

string
по умолчанию:"CHN"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса баз данных.Пример: CHN
string
по умолчанию:"chn_national_id"
обязательно
Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос именно этой базой данных.Пример: chn_national_id
Явное согласие конечного пользователя на этот сервис.Пример: true
string
по умолчанию:"王新伟"
обязательно
Полное официальное имя для проверки.Пример: 王新伟
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"11010519900101003X"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: 11010519900101003X
string
по умолчанию:"user-1234"
Ваш постоянный идентификатор пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

  • Дата рождения должна совпадать с датой, закодированной в китайском национальном идентификационном номере (цифры 7–14 из 18-значного номера или цифры 7–12 из устаревшего 15-значного)
  • date_of_birth должна совпадать с датой рождения, закодированной в national_id; источник сразу отклоняет запрос, если две даты не совпадают, поэтому запрос с несовпадением отклоняется до поиска и плата не взимается.
  • national_id должен соответствовать шаблону (\d{15}|\d{17}[\dXx]).
  • Проверяется последний контрольный символ китайского удостоверения личности гражданина.
  • full_name должно быть оригинальным написанием имени на китайском языке, как в реестре или в документе. Для проверок по базам данных Китая не отправляйте латинскую транслитерацию.

Как вызвать

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

Точный набор полей в source_data зависит от того, что возвращает реестр. Сгенерированный пример для chn_national_id на данный момент описывает следующую нормализованную структуру:
  • date_of_birth
  • identification_number

Цены и SLA

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

Продолжите чтение

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