메인 콘텐츠로 건너뛰기
POST
이 서비스는 중국의 공식 데이터 서비스를 통해 입력 데이터를 검증합니다. Didit는 POST /v3/database-validation/ endpoint로 이 서비스를 제공하므로, 제출된 데이터를 권위 있는 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다. 입력 형식: date_of_birth는 중국 국민 신분증에 인코딩된 생년월일과 일치해야 합니다(18자리 번호의 714번째 자리, 구형 15자리 번호의 712번째 자리).

적용 범위

  • 적용 범위: ~ 100%
  • 국가: 중국
  • 서비스 ID: chn_passport_verification
  • 데이터 도메인: 문서
  • 카테고리: 여권

입력

  • 필수 입력: full_name, date_of_birth, national_id, passport_number
  • 선택 입력: vendor_data
  • 동의: 필수
  • 워크플로 제공 여부: 워크플로에서 사용 가능
  • 적용 범위: ~ 100%
  • 가격: 성공한 쿼리당 $1.67
이 서비스가 허용하는 모든 문서에 조회 기준이 되는 식별자가 들어 있는 것은 아닙니다. 문서에서 식별자가 추출되지 않으면 검사는 해당 없음으로 기록되며, 데이터베이스를 조회하지 않고 요금도 청구되지 않습니다. 일부 국가에서는 이런 경우가 실제 사용자의 상당 부분을 차지합니다. 이러한 사용자도 포함하려면 설문지 답변, Document AI 추출 필드, 또는 세션을 생성할 때 전송하는 값에서도 식별자를 수집하고, 데이터베이스 검증 단계에서 이를 매핑하십시오.

요청 본문 파라미터

string
기본값:"CHN"
필수
이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다.예시: CHN
string
기본값:"chn_passport_verification"
필수
이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청 범위가 정확히 이 데이터베이스로 제한됩니다.예시: chn_passport_verification
이 서비스에 대한 최종 사용자의 명시적 동의입니다.예시: true
string
기본값:"王新伟"
필수
검증할 전체 법적 성명입니다.예시: 王新伟
string
기본값:"1990-01-01"
필수
YYYY-MM-DD 형식의 생년월일입니다.예시: 1990-01-01
string
기본값:"11010519900101003X"
필수
이 서비스에 사용하는 국민 신원 번호입니다.예시: 11010519900101003X
string
기본값:"SAMPLE-PASS-12345"
필수
여권 번호입니다.예시: SAMPLE-PASS-12345
string
기본값:"user-1234"
내부 사용자 ID처럼 이 사람을 나타내는 고정된 사용자 참조값입니다. Didit는 이 값을 사용해 독립형 검사를 같은 최종 사용자와 연결하고 중복 탐지 노이즈를 줄입니다.예시: user-1234

입력 규칙 및 검증 참고 사항

  • 생년월일은 중국 국민 신분증에 인코딩된 생년월일과 일치해야 합니다(18자리 번호의 714번째 자리, 구형 15자리 번호의 712번째 자리).
  • date_of_birth는 national_id에 인코딩된 생년월일과 일치해야 합니다. 두 값이 일치하지 않으면 출처가 요청을 즉시 거부하므로, 이 불일치는 조회 전에 거부되며 요금이 청구되지 않습니다.
  • national_id는 (?:\d{15}|\d{17}[\dXx]) 패턴과 일치해야 합니다.
  • 중국 주민 신분증의 마지막 검사 문자가 검증됩니다.
  • full_name은 등록부나 문서에 기재된 원래의 중국어 문자 이름이어야 합니다. 중국 데이터베이스 검사에는 라틴 문자 음역을 보내지 마십시오.

호출 방법

반환 데이터

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

요금 및 SLA

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

계속 읽기

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