Перейти к основному содержанию
POST
Проверяет нигерийский национальный идентификационный номер (NIN) по реестру National Identity Management Commission. Требуется селфи: портрет регистрации, связанный с NIN, сравнивается с селфи по лицу, а запись возвращается только в том случае, если они принадлежат одному и тому же человеку. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверять отправленные данные с официальным источником и получать нормализованные результаты сопоставления.

Покрытие

  • Покрытие: ~ 100%
  • Страна: Нигерия
  • ID сервиса: nga_national_id_facial
  • Домен данных: Идентификационные данные
  • Категория: NationalIDRegistry

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

  • Обязательные входные данные: national_id, selfie
  • Необязательные входные данные: first_name, last_name, date_of_birth, vendor_data
  • Согласие: Не требуется
  • Доступность в сценарии: Доступно в сценарии
  • Покрытие: ~ 100%
  • Цена: $0.35 за успешный запрос
Не каждый документ, который принимает этот сервис, содержит идентификатор, по которому выполняется запрос. Если идентификатор не извлечён из документа, проверка фиксируется как неприменимая: база данных не запрашивается, и с вас не взимается плата. Для некоторых стран такая ситуация характерна для значительной доли реальных пользователей. Чтобы охватить и их, также получайте идентификатор из ответа в анкете, из поля извлечения Document AI или из значения, которое вы передаёте при создании сессии, и сопоставляйте его на шаге «Проверка по базам данных».

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

string
по умолчанию:"NGA"
обязательно
Код страны ISO 3166-1 alpha-3 для этого сервиса проверки по базам данных.Пример: NGA
string
по умолчанию:"nga_national_id_facial"
обязательно
Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос этой конкретной базой данных.Пример: nga_national_id_facial
string
по умолчанию:"11111111111"
обязательно
Национальный идентификационный номер для этого сервиса.Пример: 11111111111
file
обязательно
Файл изображения селфи для загрузки в целях биометрической проверки по базе данных. Допустимые форматы: JPEG, PNG или WebP.Пример: @./selfie.jpg
string
Имя для проверки.Пример: John
string
Фамилия для проверки.Пример: Doe
string
Дата рождения в формате YYYY-MM-DD.Пример: 1990-01-01
string
по умолчанию:"user-1234"
Ваш стабильный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество лишних срабатываний при обнаружении дубликатов.Пример: user-1234

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

  • first_name должен соответствовать шаблону [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • national_id должен содержать только цифры: перед отправкой запроса удалите пробелы, дефисы и знаки препинания.
  • national_id должен быть ровно 11 символов в длину.

Как вызвать

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

Точный набор полей в source_data зависит от того, что возвращает реестр. Сгенерированный пример для nga_national_id_facial сейчас описывает такую нормализованную структуру:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

Цены и SLA

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

Селфи и сравнение лиц

Реестр NIMC возвращает полную запись владельца по действительному NIN, поэтому знание номера не доказывает, что вы являетесь его владельцем. Поэтому каждый запрос привязан к селфи: оно сравнивается с фото из регистрации, которое NIMC хранит для этого NIN, и запись возвращается только в том случае, если на обоих снимках один и тот же человек.
  • Совпадение: source_data содержит запись NIMC и face_match_score. Имена и дата рождения, которые вы отправляете, сравниваются с этой записью и отражаются в validation. Отправьте их, чтобы получить вердикт по имени и дате рождения, или не передавайте их и берите значения реестра из source_data.
  • Другой человек: BIOMETRIC_NO_MATCH. Возвращается только face_match_score, персональные данные не возвращаются.
  • Сравнение невозможно: INCONCLUSIVE, если NIMC не хранит фото для этого NIN или на снимке не удалось найти лицо. Ничего не возвращается, проверка отправляется на ручную проверку.
  • Неизвестный NIN: DOCUMENT_NOT_FOUND. Запрос тарифицируется.
В сценарии селфи берётся из шага проверки живости или сравнения лиц, а если в сценарии нет шага с лицом, то с портрета на загруженном документе. Запрос без селфи или с NIN, который состоит не из 11 цифр, отклоняется до того, как что-либо будет тарифицировано.

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

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