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

Покрытие

  • Покрытие: ~ 90%
  • Страна: Таиланд
  • Идентификатор сервиса: tha_national_id
  • Домен данных: Identity
  • Категория: NationalIDRegistry

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

  • Обязательные входные данные: first_name, last_name, date_of_birth, national_id
  • Необязательные входные данные: address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Согласие: Обязательно
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 90%
  • Цена: $0.59 за успешный запрос

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

string
по умолчанию:"THA"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса баз данных.Пример: THA
string
по умолчанию:"tha_national_id"
обязательно
Массив, содержащий идентификатор этого сервиса. Закрепление сервиса ограничивает запрос этой конкретной базой данных.Пример: tha_national_id
Явное согласие конечного пользователя на использование этого сервиса.Пример: true
string
по умолчанию:"John"
обязательно
Имя, которое нужно проверить.Пример: John
string
по умолчанию:"Doe"
обязательно
Фамилия, которую нужно проверить.Пример: Doe
string
по умолчанию:"1990-01-01"
обязательно
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"1111111111111"
обязательно
Номер национального идентификатора для этого сервиса.Пример: 1111111111111
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 разобьет её на структурированные элементы адреса, когда это возможно, либо вы можете явно передать структурированные поля.
  • Номер тайского национального идентификатора: 13 цифр, последняя из которых является контрольной цифрой по модулю 11 (веса от 13 до 2 для первых двенадцати цифр).
  • national_id должен содержать только цифры; перед отправкой запроса удалите пробелы, дефисы и знаки пунктуации.
  • Длина national_id должна составлять ровно 13 символов.
  • Контрольная цифра тайского национального идентификатора (модуль 11) проверяется; номер, не прошедший проверку, отклоняется до поиска и не тарифицируется.
  • Для сервисов проверки по адресу по возможности передавайте структурированные поля адреса вместо одной строки address.
  • address.street_1: адрес улицы, включая номер дома и тип улицы.
  • address.street_2: квартира, офис, корпус, этаж или дополнительная строка адреса. Передавайте её, только если она у вас есть.
  • address.city: город, пригород, район, населенный пункт или микрорайон.
  • address.region: штат, провинция, регион или поселок.
  • address.postal_code: почтовый индекс.
  • Сервисы проверки по адресу требуют как минимум адрес улицы и почтовый индекс; запросы, отклоненные до обращения к источнику, не тарифицируются.

Как вызвать

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

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

Цены и SLA

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

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

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