메인 콘텐츠로 건너뛰기
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는 이 값을 사용해 독립 실행형 검사를 같은 최종 사용자에 연결하고 중복 탐지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 위에 나열된 필드는 사용자 또는 문서에서 캡처한 값 그대로 보내야 합니다.
  • Didit는 데이터베이스를 호출하기 전에 필수 필드를 검증합니다. 원본 조회 전에 거부된 요청에는 요금이 청구되지 않습니다.

호출 방법

반환 데이터

source_data에 표시되는 정확한 필드는 등록부가 반환하는 내용에 따라 달라집니다. zaf_dha_fingerprint_match에 대해 생성된 예시는 현재 다음과 같은 정규화된 형태를 문서화합니다:
  • identification_number

요금 및 SLA

남아프리카공화국 - DHA 지문 대조 쿼리는 Didit가 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다.
  • 호출당 가격: $1.28 USD.
  • 과금: 성공한 쿼리 건당. 등록부에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 원본에 도달하기 전에 거부된 경우에는 요금이 청구되지 않습니다.
  • 지연 시간: p95 기준 일반적으로 2초 미만입니다.
  • 가용성: Didit 측 기준 분기당 99.9%. 하위 소스의 가용성은 국가와 데이터 세트에 따라 다릅니다.

계속 읽기

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