여권은 파서에게 선물을 하나 줍니다. 바로 기계 판독 영역(MRZ)입니다. 신원 정보 면 아래쪽에 대문자, 숫자, < 채움 문자가 늘어선 블록으로, 그 항목들로부터 체크 디지트가 계산되어 있습니다. 영역을 읽고 디지트를 다시 계산하면, 어떤 항목이든 믿기 전에 판독 결과가 앞뒤가 맞는지 알 수 있습니다.
운전면허증은 보통 그 어느 것도 주지 않습니다. 대부분의 발급 기관은 면허증에 기계 판독 영역을 아예 인쇄하지 않으므로 다시 계산할 것이 없습니다. 첫 파이프라인을 여권으로 만든 개발자들은 이 사실을 힘들게 알게 되는 경우가 많습니다. "MRZ를 검증하는" 코드가 영역 없는 카드를 만나, 아무 문제 없는 면허증을 오류로 처리하기 시작하는 것이죠.
이 글은 바로 그 경우에 관한 것입니다. 면허증이 영역 대신 무엇을 담고 있는지, 인식 API가 그에 대해 무엇을 알려 줄 수 있고 무엇을 알려 줄 수 없는지, 그리고 기댈 체크 디지트가 없을 때 항목을 직접 확인하는 방법을 다룹니다. 인용문의 원문은 영어이며, 한국어 번역은 저희가 했습니다.
이곳은 여권 및 신분증 OCR API doc.cheap의 블로그입니다. 제품에 관한 부분은 이 점을 염두에 두고 읽어 주세요.
면허증이 대신 담고 있는 것
면허증 형식은 하나가 아닙니다. 발급 기관마다 자체 카드를 디자인하며, 존재하는 표준들은 카드에 무엇을 담고 어떻게 배치해야 하는지를 정할 뿐, 파싱할 하나의 고정된 문자열을 정하지는 않습니다.
북미: 뒷면의 바코드. 미국 자동차 행정관 협회(AAMVA)는 회원 기관이 발급하는 카드를 위해 AAMVA DL/ID Card Design Standard를 발행합니다. 그 2026년판에는 "필수 PDF417 바코드"라는 제목의 부속서가 있으며, 이렇게 말합니다. "PDF417 2차원 바코드 심볼로지는 준수 DL/ID 문서에 반드시 있어야 하는 최소한의 필수 기계 판독 기술이다." 같은 부속서는 이어서 "모든 필수 및 선택 데이터는 암호화되지 않아야 한다"고 덧붙입니다. 즉 준수 카드는 소지자의 데이터를 두 번 담습니다. 앞면에 인쇄된 형태로, 그리고 디코더만 있으면 누구나 읽을 수 있는 2차원 바코드로 인코딩된 형태로.
EU: 표준 카드 모델을 앞면에서 읽는다. EU의 면허증 교환 및 인정에 관한 Your Europe 페이지는 현재의 면허증을 "새로운 EU 표준 형식(플라스틱, 신용카드 크기의 사진 카드)"이라고 설명합니다. 레이아웃은 공통이지만, 거기서 읽는 것은 인쇄된 텍스트입니다. 오래된 종이 면허증도 아직 유통되고 있습니다. 같은 페이지에는 "구형 EU 면허증을 가지고 있다면 모든 EU 국가에서 여전히 사용할 수 있다"고 되어 있으며, 그런 면허증은 "늦어도 2033년까지" 교환해야 한다고 합니다.
국제적인 층위. AAMVA 자체 페이지는 국제 면허증 표준 작업이 ISO에서 이루어진다고 밝히며, "국제 표준(18013)은 자동차 운전면허증(DL)의 형식과 내용에 관한 지침을 정한다"고 말합니다. 이 표준이 다루는 기술로 "1차원 및 2차원 바코드"와 "광학 문자 인식" 등을 꼽습니다. 다시 말해 이 표준은 발급 기관에 선택을 맡길 뿐, 체크 디지트가 달린 영역을 건네주지는 않습니다.
파서에게 실제로 의미하는 바는 다음과 같습니다.
| 여권 | 운전면허증 | |
|---|---|---|
| 기계 판독 영역 | 항상, 신원 정보 면에 | 보통 없음 |
| 다시 계산할 수 있는 체크 디지트 | 있음, 영역에 대해 | 영역이 없으면 없음 |
| 데이터의 두 번째 사본 | 영역 | 발급 기관이 인쇄한 경우 바코드(보통 뒷면) |
| 만료일 | 신원 정보 면에 인쇄 | 만료일이 있으면 인쇄. 평생 유효한 것도 있음 |
| 판독이 일관됨을 알려 주는 것 | 영역과 인쇄된 면의 대조 | 인쇄된 항목에 대한 자체 검사 |
"영역 없음"을 "무효"로 보면 안 되는 이유
파이프라인을 여권으로 시작했다면 아마 영역을 기준으로 분기하고 있을 것입니다. 통과하면 계속, 실패하면 새 사진을 요청. 면허증은 세 번째 답을 추가하며, 그것이 흔한 답입니다.
doc.cheap는 영역을 하나의 판정 mrz.status로 보고하며, 값은 세 가지입니다. passed는 영역이 있고 모든 체크 디지트가 검증되었다는 뜻입니다. failed는 영역을 읽었지만 그 안의 무언가가 맞지 않았다는 뜻입니다. absent는 문서에 영역이 없다는 뜻이며, 이때 reason, lines, text는 모두 null입니다. 운전면허증 가이드는 이를 분명히 말합니다. "absent를 오류가 아닌 평범한 결과로 취급하세요."
문서의 나머지 부분은 영향을 받지 않습니다. 면허증은 다른 문서와 마찬가지로 인쇄된 앞면에서 인식되며, meta.status는 recognized로 돌아옵니다. 그러니 필요한 분기는 "영역 통과, 아니면 거부"가 아니라 다음과 같습니다.
failed– 영역 안의 무언가가 맞지 않음. 더 좋은 사진을 요청합니다.passed– 영역 검사를 통과함. 계속 진행합니다.absent– 검사할 것이 없었음. 아래의 자체 항목 검사로 넘어갑니다.
API 호출 한 번으로 읽기
면허증은 여권과 같은 엔드포인트에 같은 본문으로 보냅니다. 사진을 base64로 인코딩해 JSON에 담아 POST /v1/scans를 한 번 보내면 됩니다. 공개 샌드박스 키 sk_sandbox_public은 계정 없이 사용할 수 있습니다. 이 키에는 테스트 이미지를 쓰고, 실제 면허증은 절대 쓰지 마세요. 공개 키로 한 모든 스캔은 서비스 자체 기록을 위해 1년 동안 보관됩니다.
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"
면허증에서 중요한 응답 부분은 다음과 같습니다. 모든 값은 가상의 것이며, 발급 국가는 견본 문서가 쓰는 가상의 국가 UTO입니다.
{
"meta": { "status": "recognized", "billed": true, "confidence": "high" },
"document": {
"country": "UTO",
"number": "DL0000000",
"issue_date": "2024-05-02",
"expiry_date": "2034-05-01",
"is_expired": false,
"days_remaining": 2725
},
"holder": {
"surname": "SPECIMEN",
"given_names": "ALEX JORDAN",
"birth_date": "1990-01-01"
},
"fields": [
{ "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
"category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
{ "id": "authority@0", "name": "authority", "label": "Issuing authority",
"category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
],
"mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
"authenticity": { "overall": "not_checked", "checks": [] }
}
여기서 읽어야 할 것:
fields에 면허증 고유의 데이터가 들어 있습니다. 항목 카탈로그는 면허증이 보통 담고 있는 항목을 나열합니다.surname,given_names,birth_date,document_number,dl_class또는permit_class,issue_date,expiry_date,address,authority입니다. 주소의 각 부분(address_street,address_city,address_state,address_postal_code)은 전체 주소와 별도로도 제공됩니다. 이 집합은 열려 있으므로, 어휘에 이름이 없는 항목도other카테고리로 제공됩니다.- 키는
name이 아니라id로. 두 가지 문자로 인쇄된 면허증은 같은name아래 언어마다 항목을 하나씩 반환합니다. 고유한 것은id뿐입니다. document.expiry_date,is_expired,days_remaining은 인쇄된 만료일로부터, 스캔한 날을 기준으로 계산됩니다.
바코드가 더해 주는 것, 그리고 API가 그것을 다루는 방식
디코딩된 바코드는 응답 안에 별도의 그룹을 갖지 않습니다. 그 값은 다른 모든 것과 나란히 fields에 들어오며, 바코드를 잘라 낸 경우 images.barcode에 그 잘라 낸 이미지가 담깁니다.
실무상 주의할 점이 하나 있습니다. 엔드포인트는 호출 한 번에 이미지 한 장을 읽고, 바코드를 인쇄하는 발급 기관은 보통 카드 뒷면에 둡니다. 바코드에 담긴 내용이 필요하다면 뒷면을 별도의 스캔으로 보내고 두 결과를 직접 합치세요. 이 병합은 체크 디지트를 대신할 수 있는 가장 좋은 방법이기도 합니다. 같은 카드를 독립적으로 두 번 읽은 결과이니 서로 일치해야 합니다.
체크 디지트 없이 면허증 검증하기
영역이 없으면 일관성 확인은 여러분의 몫입니다. 아래 검사 중 어느 것도 면허증이 진본임을 증명하지는 않습니다. 오판독과 명백히 잘못된 입력을 데이터베이스에 닿기 전에 잡아내는 것이 목적입니다.
- 날짜의 순서.
birth_date는issue_date보다 앞,issue_date는 스캔한 날 이전이거나 같은 날,expiry_date는issue_date보다 뒤. 순서가 어긋난 판독은 오판독이거나 나쁜 사진입니다. - 만료일은 규칙이 아니라 문서에서. 유효 기간은 발급 기관마다 다릅니다. EU 페이지 자체의 예는 키프로스 면허증이 "이탈리아처럼 10년이 아니라 15년 동안 유효"하다는 것입니다. 날짜는 카드에서 읽고, 계산하지 마세요.
- 만료일이 없는 경우에 대비하기. 같은 EU 페이지는 "평생 유효한 EU 운전면허증"을 언급합니다. 만료일을 읽지 못했을 때는
expiry_date,is_expired,days_remaining이 함께null이 되고, 파생 항목days_to_expire도null이 됩니다. 그때 흐름이 무엇을 할지 정해 두고,null을 실수로 만료로도 유효로도 취급하지 마세요. - 존재 여부가 아니라 종류. 승용차 운전 자격이 필요하다면, 면허증이 있는지 확인하는 대신
dl_class또는permit_class에서 해당 종류를 찾으세요. 값은B, BE같은 인쇄된 텍스트이므로 대조하기 전에 나누고, 여러분의 관할 지역이 정한 종류를 기준으로 대조하세요. - 앞면과 뒷면 대조. 카드에 바코드가 있다면 양면을 스캔하고 이름, 생년월일, 문서 번호를 비교하세요. 불일치가 있다면 사진을 한 번 더 받을 가치가 있습니다.
- 사용자가 입력한 내용과 대조.
holder.surname과holder.birth_date를 사용자가 작성한 양식과, 같은 방식으로 정규화한 뒤 비교하세요. - 신뢰도를 신호로. 모든 판독 값에는
high,medium,low중 하나의 등급이 붙습니다. 의존하는 항목이low라면 새 사진을 요청할 충분한 이유가 됩니다.
영역이 없을 때 스캔 비용
라이브 키에서는 문서 유형이 판별되었고 다음 세 가지 중 하나가 참일 때 스캔이 크레딧 1개를 차감합니다. 영역을 읽었고 체크 디지트가 통과했거나, 육안 판독 영역의 항목을 5개 이상 읽었거나, 바코드를 디코딩한 경우입니다. 따라서 면허증은 두 번째나 세 번째 조건으로 과금됩니다. 항목 5개도 나오지 않고 바코드도 없는 너무 나쁜 사진은 무료입니다. 전체 정의는 과금 규칙에 있습니다.
OCR이 알려 주지 않는 것
면허증을 읽는 일과 검증하는 일은 서로 다른 작업입니다. doc.cheap는 카드에 인쇄된 내용과, 뒷면에서는 바코드를 읽습니다. 인식 전용 시나리오에서 authenticity.overall은 not_checked이므로, 카드가 진본인지, 정지되지 않았는지, 들고 있는 사람이 실제 소지자인지는 알려 주지 않습니다. 흐름에 그중 하나라도 필요하다면, 그것들은 그 목적으로 만들어진 도구와 기록을 쓰는 별도의 단계입니다.
직접 해 보기
공개 샌드박스 키는 계정이 필요 없습니다. 가입하면 자신의 키로 매달 100회의 무료 인식을 사용할 수 있으며, 앞면, 뒷면, 자체 검사까지 전체 흐름을 만들기에 충분합니다. 제공업체를 고르고 있다면 여권 OCR API 비교에서 공개된 가격을 나란히 볼 수 있고, 운전면허증 가이드에는 curl, JavaScript, Python 호출 방법과 광택 있는 카드를 촬영하는 요령이 있습니다.
질문 하나 드립니다. 면허증에 영역이 없을 때, 여러분의 흐름에서 잘못된 판독을 가장 많이 잡아내는 검사는 무엇인가요 – 날짜, 뒷면의 바코드, 아니면 다른 무언가인가요? 아래 댓글로 알려 주세요.