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

Охват

  • Охват: > 75%
  • Страна: Малайзия
  • ID сервиса: mys_national_id
  • Область данных: Идентификация
  • Категория: NationalIDRegistry

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

  • Обязательные входные данные: full_name, date_of_birth, national_id
  • Необязательные входные данные: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, vendor_data
  • Согласие: обязательно
  • Доступность в сценарии: доступно в сценарии
  • Охват: > 75%
  • Цена: $0.59 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как не применима: база данных не запрашивается, и с вас ничего не списывается. Для некоторых стран такие пользователи составляют значительную долю реальных пользователей. Чтобы охватить и их, также собирайте идентификатор из ответа на анкету, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставляйте его на шаге проверки по базам данных.

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

string
по умолчанию:"MYS"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: MYS
string
по умолчанию:"mys_national_id"
обязательно
Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос именно этой базой данных.Пример: mys_national_id
Явное согласие конечного пользователя на этот сервис.Пример: true
string
по умолчанию:"John Doe"
обязательно
Полное юридическое имя для проверки.Пример: John Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"111111111111"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: 111111111111
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
Номер телефона в международном формате.Пример: +15550101000
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого человека, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при поиске дубликатов.Пример: user-1234

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

  • address для этого сервиса необязателен. Можно отправить одну полную строку address, и Didit разделит её на структурированные элементы адреса, когда это возможно, либо можно явно передать структурированные поля.
  • national_id должен содержать только цифры: перед отправкой запроса удалите пробелы, дефисы и знаки препинания.
  • national_id должен содержать ровно 12 символов.
  • Для сервисов, работающих с адресом, по возможности отправляйте структурированные поля адреса вместо одной строки address.
  • address.street_1: адрес улицы, включая номер дома и тип улицы.
  • address.street_2: квартира, офис, корпус, этаж или дополнительная строка адреса. Передавайте её, только если она у вас есть.
  • address.city: город, пригород, район, населённый пункт или микрорайон.
  • address.region: штат, провинция, регион или населённый пункт.
  • address.postal_code: почтовый индекс.
  • Сервисы проверки по базам данных на основе адреса требуют как минимум адрес улицы и почтовый индекс. Запросы, отклонённые до поиска в источнике, не оплачиваются.

Как вызвать API

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

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

Цены и SLA

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

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

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