Проверка по базам данных ЮАР: файлы беженцев

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

POST

database-validation

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

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

Покрытие

Покрытие: —
Страна: Южная Африка
ID сервиса: zaf_refugee
Область данных: Идентификация
Категория: Государственные органы

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

Поле	Обязательное	Пример
`refugee_file_number`	Да	`RF123456`
`phone_number`	Нет	`+15550101000`
`email`	Нет	`john.doe@example.com`
`vendor_data`	Нет	`user-1234`

Обязательные входные данные: refugee_file_number
Необязательные входные данные: phone_number, email, vendor_data
Согласие: Не требуется
Доступность в сценарии: Доступна в сценарии с сопоставлением полей
Покрытие: —
Цена: $1.28 за успешный запрос

В сценарии refugee_file_number не печатается в документе, удостоверяющем личность, поэтому ни один шаг не формирует его сам по себе. Получите его из ответа на вопрос анкеты, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге «Проверка по базам данных». Пока поле не сопоставлено, редактор сценариев показывает этот сервис неактивным и называет недостающий входной параметр. Во время выполнения отсутствие параметра означает, что проверка пропускается до любого запроса, поэтому с вас не берётся плата за базу данных, которую не удалось запросить.

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

string

по умолчанию:"ZAF"

обязательно

Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: ZAF

string

по умолчанию:"zaf_refugee"

обязательно

Массив, содержащий ID этого сервиса. Указание сервиса ограничивает запрос этой конкретной базой данных.Пример: zaf_refugee

string

по умолчанию:"RF123456"

обязательно

Значение refugee_file_number, обязательное для этого сервиса базы данных.Пример: RF123456

string

Значение phone_number, обязательное для этого сервиса базы данных.Пример: +15550101000

string

Адрес электронной почты.Пример: john.doe@example.com

string

по умолчанию:"user-1234"

Ваш постоянный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при обнаружении дубликатов.Пример: user-1234

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

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

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

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"

Каждый успешный вызов возвращает HTTP 200. Поле outcome_code показывает, что произошло на самом деле: например, оно отличает реальное несовпадение биометрии (BIOMETRIC_NO_MATCH) от селфи, которое не удалось распознать (BIOMETRIC_IMAGE_UNUSABLE). Указанный status — это статус функции по умолчанию; ваши настроенные действия для частичного совпадения / отсутствия совпадения могут его переопределить.

MATCH: реестр подтвердил личность, и все проверенные поля совпали.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

NO_MATCH: реестр не вернул совпадений для отправленных данных.

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

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

Конкретные поля, которые попадают в source_data, зависят от того, что вернёт реестр. Сгенерированный пример для zaf_refugee сейчас описывает такую нормализованную структуру:

Зависит от ответа реестра.

Цены и SLA

Запросы на проверку дела беженца в ЮАР тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.

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

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

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

​Покрытие

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

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

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

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

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

​Цены и SLA

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

Покрытие

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

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

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

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

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

Цены и SLA

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