> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 나이지리아 국가 신분증 + 셀피(NIMC) 신분증 인증 API > 나이지리아 국가 신분증 + 셀피(NIMC): Didit로 공신력 있는 나이지리아 데이터베이스 조회. 호출당 $0.35부터, 계약 및 최소 사용량 없음. 나이지리아 국가 신원 번호(NIN)를 국가신원관리위원회(NIMC) 등록부와 대조하여 검증합니다. 셀피가 필요합니다. NIN에 연결된 등록 사진과 셀피를 얼굴 대조하며, 두 사진 속 인물이 동일인인 것으로 확인될 때만 기록이 반환됩니다. Didit은 이 서비스를 `POST /v3/database-validation/`을 통해 제공하므로, 제출된 데이터를 공신력 있는 원천 데이터와 대조하고 정규화된 일치 결과를 받을 수 있습니다. ## 적용 범위 * **적용 범위:** \~ 100% * **국가:** 나이지리아 * **서비스 ID:** `nga_national_id_facial` * **데이터 영역:** 신원 * **카테고리:** NationalIDRegistry ## 입력 값 | 필드 | 필수 여부 | 예시 | | - | -: | - | | `national_id` | 예 | `11111111111` | | `selfie` | 예 | `@./selfie.jpg` | | `first_name` | 아니요 | `John` | | `last_name` | 아니요 | `Doe` | | `date_of_birth` | 아니요 | `1990-01-01` | | `vendor_data` | 아니요 | `user-1234` | * **필수 입력 값:** `national_id`, `selfie` * **선택 입력 값:** `first_name`, `last_name`, `date_of_birth`, `vendor_data` * **동의:** 필요하지 않음 * **워크플로 제공 여부:** 워크플로에서 사용 가능 * **적용 범위:** \~ 100% * **가격:** 성공한 조회 건당 \$0.35 이 서비스가 허용하는 모든 문서에 조회에 사용하는 식별자가 포함되는 것은 아닙니다. 문서에서 식별자가 추출되지 않으면 검사는 **해당 없음**으로 기록되며, 데이터베이스가 조회되지 않고 요금도 청구되지 않습니다. 일부 국가에서는 이런 경우가 실제 사용자의 상당 부분을 차지합니다. 이러한 사용자를 포괄하려면 설문지 응답, Document AI 추출 필드 또는 세션을 생성할 때 전달하는 값에서도 식별자를 수집하고, 데이터베이스 검증 단계에서 이를 매핑하십시오. ## 본문 파라미터 **issuing\_state** `string` *required* (default: NGA) 이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다. 예시: `NGA` **services** `string` *required* (default: nga\_national\_id\_facial) 이 서비스 ID를 포함하는 배열입니다. 서비스 ID를 고정하면 요청 범위가 이 정확한 데이터베이스로 제한됩니다. 예시: `nga_national_id_facial` **national\_id** `string` *required* (default: 11111111111) 이 서비스에 사용하는 국가 신원 번호입니다. 예시: `11111111111` **selfie** `file` *required* 생체 데이터베이스 검증을 위해 업로드할 셀피 이미지 파일입니다. 허용되는 형식은 JPEG, PNG 또는 WebP입니다. 예시: `@./selfie.jpg` **first\_name** `string` 검증할 이름입니다. 예시: `John` **last\_name** `string` 검증할 성입니다. 예시: `Doe` **date\_of\_birth** `string` `YYYY-MM-DD` 형식의 생년월일입니다. 예시: `1990-01-01` **vendor\_data** `string` (default: user-1234) 이 사용자를 나타내는 고정 사용자 참조 값으로, 예를 들어 내부 사용자 ID입니다. Didit은 이 값을 사용하여 단독 검사를 같은 최종 사용자에게 연결하고 중복 탐지 노이즈를 줄입니다. 예시: `user-1234` ## 입력 규칙 및 검증 참고 사항 * `first_name`은 `[A-Za-zÀ-ÖØ-öø-ÿ .'-]+` 패턴과 일치해야 합니다. * `national_id`는 숫자만 포함해야 합니다. 요청을 보내기 전에 공백, 하이픈 및 구두점을 제거하십시오. * `national_id`는 정확히 11자여야 합니다. ## 호출 방법 ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=NGA" \ -F "services=nga_national_id_facial" \ -F "vendor_data=user-1234" \ -F "national_id=11111111111" \ -F "selfie=@./selfie.jpg" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="NGA", services=["nga_national_id_facial"], national_id="11111111111", vendor_data="user-1234", selfie=open("selfie.jpg", "rb"), ) print(result) ``` ```javascript Node.js theme={null} import Didit, { fileFromPath } from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "NGA", services: ["nga_national_id_facial"], national_id: "11111111111", vendor_data: "user-1234", selfie: await fileFromPath("selfie.jpg"), }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "NGA", Services: didit.Some([]string{"nga_national_id_facial"}), NationalID: didit.String("11111111111"), VendorData: didit.String("user-1234"), Selfie: didit.Some(didit.FileFromPath("selfie.jpg")), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.nio.file.Path; import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("NGA") .services(List.of("nga_national_id_facial")) .nationalId("11111111111") .vendorData("user-1234") .selfie(Path.of("selfie.jpg")) .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'NGA', 'services' => ['nga_national_id_facial'], 'national_id' => '11111111111', 'vendor_data' => 'user-1234', 'selfie' => File::fromPath('selfie.jpg'), ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "NGA", services: ["nga_national_id_facial"], national_id: "11111111111", vendor_data: "user-1234", selfie: Pathname("selfie.jpg") ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "NGA", Services = new string[] { "nga_national_id_facial" }, NationalId = "11111111111", VendorData = "user-1234", Selfie = FileUpload.FromPath("selfie.jpg"), }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` 성공한 모든 호출은 HTTP `200`을 반환합니다. 실제로 무슨 일이 일어났는지는 **`outcome_code`** 필드에서 확인할 수 있습니다. 이 필드는 예를 들어 실제 생체 불일치(`BIOMETRIC_NO_MATCH`)와 읽을 수 없는 셀피(`BIOMETRIC_IMAGE_UNUSABLE`)를 구분합니다. 표시된 `status`는 기본 기능 상태이며, 구성한 [부분 일치 / 불일치 작업](https://docs.didit.me/ko/core-technology/database-validation/database-validation-warnings.md)에 따라 재정의될 수 있습니다. **`MATCH`**: 레지스트리가 신원을 확인했으며 확인된 모든 필드가 일치했습니다. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "NGA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "nga_national_id_facial", "service_name": "Nigeria National ID + Selfie (NIMC)", "source_data": { "address": "1 SAMPLE STREET", "birth_country": "nigeria", "birth_lga": "Ikeja", "birth_state": "Lagos", "date_of_birth": "1990-01-01", "face_match_score": 92.4, "first_name": "JOHN", "gender": "Male", "identification_number": "11111111111", "last_name": "DOE", "marital_status": "single", "middle_name": "SAMUEL", "phone_number": "08000000000", "photo_available": true, "residence_lga": "Ikeja", "residence_state": "Lagos", "residence_town": "IKEJA" }, "validation": { "date_of_birth": "full_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`**: 셀피가 등록된 사진과 일치하고 NIN이 등록부에 있지만, 전송한 이름 또는 생년월일이 NIMC 기록과 다릅니다. 어떤 필드가 다른지 확인할 수 있도록 기록이 반환됩니다. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "NGA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "nga_national_id_facial", "service_name": "Nigeria National ID + Selfie (NIMC)", "source_data": { "address": "1 SAMPLE STREET", "birth_country": "nigeria", "birth_lga": "Ikeja", "birth_state": "Lagos", "date_of_birth": "1990-02-01", "face_match_score": 92.4, "first_name": "JOHN", "gender": "Male", "identification_number": "11111111111", "last_name": "DOE", "marital_status": "single", "middle_name": "SAMUEL", "phone_number": "08000000000", "photo_available": true, "residence_lga": "Ikeja", "residence_state": "Lagos", "residence_town": "IKEJA" }, "validation": { "date_of_birth": "no_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`BIOMETRIC_NO_MATCH`**: NIN은 등록부에 있지만, 셀피 속 인물이 NIMC 등록 사진 속 인물과 동일인이 아닙니다(얼굴 대조 점수가 허용 임계값 미만). 기록의 어떤 내용도 반환되지 않으며, 점수만 반환됩니다. ```json 200 OK — BIOMETRIC_NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "NGA", "match_type": "no_match", "validations": [ { "outcome_code": "BIOMETRIC_NO_MATCH", "service_id": "nga_national_id_facial", "service_name": "Nigeria National ID + Selfie (NIMC)", "source_data": { "face_match_score": 12.5, "identification_number": "NO_MATCH" }, "validation": { "identification_number": "no_match" } } ] } ``` **`INCONCLUSIVE`**: NIN은 등록부에 있지만 얼굴 대조를 수행할 수 없습니다. 등록 사진이 없거나 얼굴이 감지되지 않았기 때문입니다. 기록의 어떤 내용도 반환되지 않으며, `match_type`은 null이고 검사는 검토 대상으로 전달됩니다. ```json 200 OK — INCONCLUSIVE theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "NGA", "match_type": null, "validations": [ { "outcome_code": "INCONCLUSIVE", "service_id": "nga_national_id_facial", "service_name": "Nigeria National ID + Selfie (NIMC)", "source_data": {}, "validation": {} } ] } ``` **`DOCUMENT_NOT_FOUND`**: NIN의 형식은 올바르지만 NIMC 등록부에 해당 기록이 없습니다. 이 조회는 과금됩니다. ```json 200 OK — DOCUMENT_NOT_FOUND theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "NGA", "match_type": "no_match", "validations": [ { "outcome_code": "DOCUMENT_NOT_FOUND", "service_id": "nga_national_id_facial", "service_name": "Nigeria National ID + Selfie (NIMC)", "source_data": { "identification_number": "NO_MATCH" }, "validation": { "identification_number": "no_match" } } ] } ``` ## 반환 데이터 `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자리 숫자가 아닌 요청은 아무것도 과금되기 전에 거부됩니다. ## 계속 읽기 * [나이지리아 데이터베이스 검증 개요](https://docs.didit.me/api-reference/database-validation/nigeria.md) * [데이터베이스 검증 개요](https://docs.didit.me/ko/core-technology/database-validation/overview.md) * [결과 코드](https://docs.didit.me/ko/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.