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

Охват

  • Охват: —
  • Страна: ЮАР
  • ID сервиса: zaf_dha_fingerprint_match
  • Домен данных: Биометрия
  • Категория: Государственная

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

  • Обязательные входные данные: national_id, right_thumb, left_thumb
  • Необязательные входные данные: vendor_data
  • Согласие: Требуется
  • Доступность в сценарии: Только в отдельном API
  • Охват: —
  • Цена: $1.28 за успешный запрос
Этому сервису нужны right_thumb и left_thumb, которые шаг сценария не формирует, поэтому он доступен только в отдельном API, где вы передаёте значения напрямую.

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

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

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

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

Как вызвать сервис

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

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

Цены и SLA

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

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

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