메인 콘텐츠로 건너뛰기
POST
이 서비스는 시민의 국민 신원 정보로 구성된 정부 기관 데이터베이스와 입력 데이터를 대조합니다. Didit은 POST /v3/database-validation/을 통해 이 서비스를 제공하므로, 제출된 데이터를 공신력 있는 원본 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다.

적용 범위

  • 적용 범위: ~ 80%
  • 국가: 캄보디아
  • 서비스 ID: khm_national_id
  • 데이터 영역: 신원
  • 카테고리: NationalIDRegistry

입력 항목

  • 필수 입력: first_name, last_name, date_of_birth, voter_id
  • 선택 입력: gender, address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • 동의: 필수
  • 워크플로 사용 가능 여부: 워크플로에서 사용 가능
  • 적용 범위: ~ 80%
  • 요금: 성공한 조회당 $0.59
이 서비스가 허용하는 모든 문서에 조회 기준 식별자가 포함되어 있지는 않습니다. 문서에서 식별자가 추출되지 않으면 검사는 해당 없음으로 기록되며, 데이터베이스는 조회되지 않고 요금도 청구되지 않습니다. 일부 국가에서는 이러한 경우가 실제 사용자의 상당 부분을 차지합니다. 이러한 사용자까지 포함하려면 설문지 응답, Document AI 추출 필드 또는 세션 생성 시 전송하는 값에서도 식별자를 수집하고, 데이터베이스 검증 단계에서 이를 매핑해야 합니다.

본문 파라미터

string
기본값:"KHM"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예: KHM
string
기본값:"khm_national_id"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스로 한정됩니다.예: khm_national_id
이 서비스에 대한 최종 사용자의 명시적 동의입니다.예: true
string
기본값:"John"
필수
검증할 이름입니다.예: John
string
기본값:"Doe"
필수
검증할 성입니다.예: Doe
string
기본값:"1990-01-01"
필수
YYYY-MM-DD 형식의 생년월일입니다.예: 1990-01-01
string
기본값:"12345678"
필수
유권자 식별자입니다.예: 12345678
string
데이터베이스에서 요구하는 경우에 사용하는 성별 값입니다.허용 값: M(남성), F(여성), X(기타 또는 알 수 없음).예: M
object
구조화된 거주지 주소 객체입니다. street_1, street_2, city, region, postal_code, country를 사용합니다. 전체 레거시 주소 문자열도 여전히 허용되지만 권장하지 않습니다.예: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
기본값:"user-1234"
내부 사용자 ID 등 이 사람을 나타내는 고정된 사용자 참조값입니다. Didit은 이 값을 사용해 단독 검사를 같은 최종 사용자와 연결하고 중복 탐지 노이즈를 줄입니다.예: user-1234

입력 규칙 및 검증 참고 사항

  • 이 서비스에서 address는 선택 항목입니다. 전체 address 문자열 하나를 보내면 가능한 경우 Didit이 이를 구조화된 주소 요소로 나누며, 구조화된 주소 필드를 명시적으로 보낼 수도 있습니다.
  • voter_id는 (?:\d{8,9}|\d{2}-\d{3}-\d{3})와 일치해야 합니다.
  • 주소 기반 서비스의 경우 가능하면 단일 address 문자열 대신 구조화된 주소 필드를 보내는 것이 좋습니다.
  • address.street_1은 번지수와 도로 유형을 포함한 도로 주소입니다.
  • address.street_2는 아파트, 호수, 건물, 층 또는 추가 주소 항목입니다. 해당 정보가 있는 경우에만 보내야 합니다.
  • address.city는 도시, 교외 지역, 구, 지구 또는 동네입니다.
  • address.region은 주, 도, 지방 또는 읍·면입니다.
  • address.postal_code는 우편번호입니다.
  • 주소 기반 데이터베이스 서비스는 최소한 도로 주소와 우편번호를 요구합니다. 원본 조회 이전에 거부된 요청에는 요금이 청구되지 않습니다.

호출 방법

반환 데이터

source_data에 노출되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. khm_national_id의 생성된 예시는 현재 다음과 같은 정규화된 형태를 문서화하고 있습니다:
  • address
  • address_match_score
  • building_number
  • city
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score
  • state
  • street

요금 및 SLA

Cambodia National ID 조회는 검증 소스로부터 확정적인 결과를 받은 경우에만 과금됩니다.
  • 호출당 가격: $0.59 USD.
  • 과금 방식: 성공한 조회 건당 과금됩니다. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 소스에 도달하기 전에 거부된 경우에는 과금되지 않습니다.
  • 지연 시간: 일반적인 p95 < 2 s.
  • 가용성: Didit 측 기준 분기당 99.9%이며, 하위 소스의 가용성은 국가와 데이터셋에 따라 다릅니다.

더 읽어보기

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