Перейти к основному содержанию
POST
Возвращает зарегистрированную в Департаменте внутренних дел ЮАР (DHA) фотографию по номеру удостоверения личности ЮАР. Didit предоставляет эту услугу через POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с первоисточником и получить нормализованные результаты сравнения.

Покрытие

  • Покрытие: —
  • Страна: ЮАР
  • ID службы: zaf_dha_photo
  • Область данных: Биометрия
  • Категория: Государственная

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

  • Обязательные входные данные: national_id
  • Необязательные входные данные: vendor_data
  • Согласие: Обязательно
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: —
  • Цена: $1.34 за успешный запрос

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

string
по умолчанию:"ZAF"
обязательно
Код страны ISO 3166-1 alpha-3 для этой службы проверки по базам данных.Пример: ZAF
string
по умолчанию:"zaf_dha_photo"
обязательно
Массив, содержащий ID этой службы. Закрепление службы ограничивает запрос этой конкретной базой данных.Пример: zaf_dha_photo
Явное согласие конечного пользователя на эту службу.Пример: true
string
по умолчанию:"SAMPLE-NID-12345"
обязательно
Номер национального удостоверения личности для этой службы.Пример: SAMPLE-NID-12345
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при обнаружении дубликатов.Пример: user-1234

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

  • Отправляйте перечисленные выше поля точно в том виде, в котором они получены от пользователя или документа.
  • Didit проверяет обязательные поля до обращения к базе данных. Запросы, отклонённые до обращения к источнику, не тарифицируются.

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

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

Конкретные поля, которые появляются в source_data, зависят от того, что возвращает реестр. Сгенерированный пример для zaf_dha_photo сейчас документирует такую нормализованную структуру:
  • birth_place_country_code
  • deceased
  • first_name
  • id_blocked
  • identification_number
  • last_name
  • marital_status
  • on_hanis_biometric_register
  • on_national_population_register
  • photo_base64
  • smart_card_issued
  • transaction_number

Цены и SLA

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

Читайте также

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