메인 콘텐츠로 건너뛰기
POST
남아프리카공화국 운전면허를 NATIS / Department of Transport 등록부와 대조하여 검증합니다. Didit은 이 서비스를 POST /v3/database-validation/을 통해 제공하므로, 제출한 데이터를 공신력 있는 원본 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다.

적용 범위

  • 적용 범위: —
  • 국가: 남아프리카공화국
  • 서비스 ID: zaf_drivers_license
  • 데이터 도메인: 신원
  • 카테고리: DriverLicence

입력값

  • 필수 입력값: national_id, last_name, initials, licence_number
  • 선택 입력값: first_name, date_of_birth, vendor_data
  • 동의: 필요하지 않음
  • 워크플로 사용 가능 여부: 필드 매핑을 설정하면 워크플로에서 사용할 수 있음
  • 적용 범위: —
  • 가격: $0.80 (성공한 쿼리당)
워크플로에서 initials와 licence_number는 신분증에 인쇄되어 있지 않으므로, 어떤 단계도 이 값을 단독으로 생성하지 않습니다. 설문지 답변, Document AI 추출 필드, 또는 세션을 생성할 때 전달하는 값에서 수집하고, 데이터베이스 검증 단계에서 각각 매핑하십시오. 매핑하기 전까지 워크플로 편집기는 이 서비스를 비활성화된 상태로 표시하고 누락된 입력값을 알려 줍니다. 실행 시 입력값이 누락되면 쿼리 전에 해당 검사가 건너뛰어지므로, 조회할 수 없었던 데이터베이스에 대해서는 요금이 청구되지 않습니다.

본문 파라미터

string
기본값:"ZAF"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시: ZAF
string
기본값:"zaf_drivers_license"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스로만 범위가 제한됩니다.예시: zaf_drivers_license
string
기본값:"SAMPLE-NID-12345"
필수
이 서비스에 사용하는 국가 신원 번호입니다.예시: SAMPLE-NID-12345
string
기본값:"Doe"
필수
검증할 성입니다.예시: Doe
string
기본값:"JD"
필수
이 데이터베이스 서비스에 필요한 initials 값입니다.예시: JD
string
기본값:"LIC123456"
필수
이 데이터베이스 서비스에 필요한 licence_number 값입니다.예시: LIC123456
string
검증할 이름입니다.예시: John
string
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01
string
기본값:"user-1234"
이 사람에 대한 고정된 사용자 참조값입니다(예: 내부 사용자 ID). Didit은 이 값을 사용해 단독 검사를 같은 최종 사용자에게 연결하고 중복 탐지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 위에 나열된 필드를 사용자나 문서에서 수집된 그대로 정확히 전송해야 합니다.
  • Didit은 데이터베이스를 호출하기 전에 필수 필드를 검증합니다. 원본 조회 전에 거부된 요청에는 요금이 청구되지 않습니다.

호출 방법

반환 데이터

source_data에 표시되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. zaf_drivers_license에 대해 생성된 예시는 현재 다음과 같은 정규화된 형태를 문서화하고 있습니다:
  • expiration_date
  • first_name
  • identification_number
  • last_name
  • licence_valid
  • vehicle_codes

요금 및 SLA

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

각 결과의 의미

이 검사는 전송하신 운전면허 번호를 남아공 신분증 번호, 성, 이니셜과 함께 운전면허 등록부에 조회합니다. 결과는 등록부가 반환하는 내용에 따라 달라집니다:
  • MATCH - 등록부가 이 운전면허 번호에 대한 면허 기록을 반환했고, 제출하신 정보가 그 기록과 일치했습니다. source_data에는 기록이 담깁니다: identification_number(면허 번호), first_name과 last_name, vehicle_codes(면허 종류, 예: EB, C1), expiration_date(면허증 만료일).
  • INCONCLUSIVE - 등록부가 조회를 받아들였지만 면허 기록을 반환하지 않았습니다. 따라서 제출하신 정보와 비교할 대상이 없었습니다. source_data.licence_valid는 true, validation은 비어 있고, match_type은 null입니다. 면허에 대해 확인된 것이 없으므로 검사는 검토로 보내집니다. 같은 요청의 다른 서비스, 예를 들어 국가 신분증 확인에서 해당 인물이 일치하더라도 마찬가지입니다. 그 결과는 사람을 확인하는 것이지 면허를 확인하는 것이 아니기 때문입니다.
  • NO_MATCH - 등록부가 면허를 조회했고 유효하지 않은 것으로 보고했습니다(source_data.licence_valid: false). 귀사의 불일치 작업이 적용됩니다.
  • REGISTRY_ERROR - 등록부가 조회를 실행하지 않았으므로 면허에 대해 확인된 것이 없습니다. 검사는 검토로 보내지며 과금되지 않습니다.
반환되지 않는 정보. 정지, 취소, 철회, 배서 또는 벌점 필드는 없습니다. 따라서 MATCH라도 사용자에게 “면허가 유효하며 정상 상태입니다”라고 표현해서는 안 됩니다. 등록부가 반환하는 경우의 expiration_date는 면허 상태와 간접적으로 관련된 유일한 정보입니다. 이 값을 세션 날짜와 비교하여 면허가 만료되었는지 판단할 수 있으며, 이는 일치 결과의 일부가 아니라 귀사의 자체 규칙으로 다루어야 합니다. 이용약관에 이 내용을 명시해야 한다면 다음과 같이 작성하십시오: Didit은 운전면허 정보를 국가 등록부와 대조하며, 등록부가 면허 기록을 반환하는 경우 면허 종류와 만료일을 확인합니다. Didit이 현재 보유자가 운전할 수 있는 면허를 가지고 있음을 확인하는 것은 아닙니다.

계속 읽기

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