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

Покрытие

  • Покрытие: ~ 90%
  • Страна: Индонезия
  • ID сервиса: idn_residential_identity_card
  • Область данных: Адрес
  • Категория: Жилая

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

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

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

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

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

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

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

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

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

Цены и SLA

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

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

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