메인 콘텐츠로 건너뛰기
POST
나이지리아 국가 신원 번호(NIN)를 국가신원관리위원회(NIMC) 등록부와 대조하여 검증합니다. 셀피가 필요합니다. 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를 포함하는 배열입니다. 서비스 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

나이지리아 국가 신분증 + 셀피(NIMC) 조회는 Didit이 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다.
  • 건당 가격: $0.35 USD.
  • 과금: 성공한 조회 건당 과금됩니다. 등록 기관에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 소스에 도달하기 전에 거부된 경우에는 과금되지 않습니다.
  • 지연 시간: 일반적인 p95 기준 2초 미만.
  • 가용성: Didit 측 기준 분기당 99.9%이며, 다운스트림 소스의 가용성은 국가 및 데이터셋에 따라 다릅니다.

셀피 및 얼굴 대조

NIMC 등록 기록은 유효한 NIN에 대해 소유자의 전체 기록을 반환하므로, 번호를 안다고 해서 그 번호의 소유자임이 증명되지는 않습니다. 따라서 모든 조회는 셀피와 연결됩니다. 셀피를 NIMC가 해당 NIN에 대해 보유한 등록 사진과 얼굴 대조하며, 두 사진의 인물이 같은 사람일 때만 기록이 반환됩니다.
  • 일치: source_data에 NIMC 기록과 face_match_score가 담깁니다. 전송한 이름과 생년월일은 이 기록과 비교되어 validation에 보고됩니다. 이름과 생년월일에 대한 판정을 받으려면 이를 전송하고, 생략하면 source_data에서 등록 기관의 값을 읽습니다.
  • 다른 사람: BIOMETRIC_NO_MATCH. face_match_score만 반환되며, 개인 정보는 반환되지 않습니다.
  • 대조 불가: NIMC가 해당 NIN에 대한 사진을 보유하지 않거나 얼굴을 찾을 수 없는 경우 INCONCLUSIVE가 반환됩니다. 아무것도 반환되지 않으며, 해당 검사는 검토로 전달됩니다.
  • 알 수 없는 NIN: DOCUMENT_NOT_FOUND. 이 조회는 과금됩니다.
워크플로에서 셀피는 라이브니스 또는 얼굴 대조 단계에서 가져오거나, 워크플로에 얼굴 단계가 없으면 업로드한 문서의 초상 사진에서 가져옵니다. 셀피가 없거나 NIN이 11자리 숫자가 아닌 요청은 아무것도 과금되기 전에 거부됩니다.

계속 읽기

마지막 수정일 2026년 11월 7일