영국 여권 OCR API 안내

영국 여권 인식 방법

영국 여권은 ICAO 9303 표준을 따릅니다. 정보면 하단, 사람이 읽는 시각 판독 영역 아래에 44자짜리 두 줄로 된 기계 판독 영역(형식 TD3)이 인쇄되어 있습니다. 처음 다섯 글자 P<GBR에는 문서 코드가 먼저 오고, 이어서 발급 국가의 ISO 3166-1 alpha-3 코드(GBR)가 들어갑니다. API는 두 영역을 모두 읽고, MRZ 체크 디지트를 교차 검증하며, 모든 키가 포함된 하나의 응답 구조를 반환합니다.

영국의 코드는 alpha-2 목록에서 GB, 영역에서는 GBR입니다. 이 경우 긴 코드는 짧은 코드 뒤에 R 한 글자를 붙인 형태입니다. 하지만 이는 이 쌍에만 해당할 뿐 규칙이 아니므로, 한쪽에서 다른 쪽을 유도하는 코드는 들어맞지 않는 첫 번째 국가를 만나는 순간 버그가 됩니다.

영국에서 발급한 기계 판독 영역

9303은 세 가지 영역 레이아웃을 정의하며, API는 세 가지를 모두 읽습니다. 아래에는 가상의 소지자 한 명(실존하지 않는 인물이며, paradeigma는 그리스어로 예시라는 뜻입니다)을 각 레이아웃으로 보여 주며, 발급 국가는 GBR입니다. 모든 체크 디지트는 손으로 입력한 것이 아니라 옆의 문자들로 계산한 것이므로, 여기 있는 모든 영역은 검증을 통과합니다.

P<GBRPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184GBR9403084F3203101PN48291630<<<<72

I<GBRPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDGBRAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<

발급 국가를 보호하는 체크 디지트는 없습니다. 세 가지 레이아웃 모두에서 계산은 문서 번호, 날짜, 선택 데이터에만 적용되며, 누가 문서를 발급했는지 나타내는 세 글자에는 적용되지 않습니다. 모든 자리가 검증을 통과한 영역이라도 영국에서 발급되었다는 것까지 증명하지는 못합니다. 그것은 시각 영역과 문서 자체의 보안 요소가 증명합니다.

MRZ 파서에 MRZ를 붙여 넣어 체크 디지트를 검증하거나, MRZ 생성기로 직접 만들어 보세요.

돌려받는 필드

인식된 영국 여권은 모두 같은 구조화된 필드를 반환합니다. 읽지 못한 값은 null이며, 키가 빠지는 일은 없습니다.

• 성과 이름
• 생년월일과 성별
• 문서 번호와 개인 번호
• 국적과 발급 국가 (GBR)
• 발급일과 만료일, 남은 일수
• MRZ 판정과 판독에 쓰인 줄

문서 필드 탐색기에서 모든 필드를 확인하세요.

호출해 보기

공개 sandbox에 대해 이 명령을 실행하세요. 가입이 필요 없고, 실제 인식이며, 제한된 수의 문서까지 무료이고 IP당 시간당 10건까지 요청할 수 있습니다. 영국 여권을 계속 인식하려면 sandbox 키를 자신의 라이브 키로 바꾸세요.

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"

관련 문서

이 페이지는 영국에만 해당하는 내용을 다룹니다. 그 밖의 모든 내용은 아래 네 페이지(영문)에 있습니다.

• 여권 인식하기

  위의 호출을 실제 문서로 curl, JavaScript, Python에서 실행하고, 응답의 모든 키를 설명합니다.

• MRZ와 시각 영역

  문서가 같은 정보를 두 번 인쇄하는 이유, 두 영역이 다를 때 어느 쪽을 믿어야 하는지, 그리고 위의 체크 디지트가 증명할 수 있는 것과 없는 것.

• 필드의 언어와 문자

  영역은 라틴 문자 음역이고, 시각 영역은 그렇지 않습니다. 어느 판독 결과에 원래 문자가 담기는지, 그리고 언어 식별자가 어떻게 언어로 해석되는지.

• 오류

  API가 응답할 수 있는 모든 오류 코드를 한 표에 담았습니다. 원인, 재시도로 성공할 수 있는지, 그리고 호출이 과금되었는지.