개발가이드

  • 개발가이드

여권 텍스트 추출(OCR)

OCR(Optical Character Recognition) 여권 사진에서 주요 정보를 텍스트로 추출합니다.

업로드 용량 제한: 50MB
첨부 이미지 합계는 최대 50MB입니다. 서버가 판독 가능한 크기로 최적화하며, 지나치게 큰 해상도는 정확도를 높이지 않고 처리시간만 늘릴 수 있습니다.
제한을 초과하면 HTTP 413과 REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.

정보

Method
URL
POST
https://apick.app/rest/ocr_identi3

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
image
File
O
여권 이미지 파일

응답

Body
이름
타입
설명
data
Object
조회 데이터
result
Object
추출 결과
name
String
이름
pass_num
String
여권 번호
made_date
String
발급 일자
exp_date
String
만료 일자
birth_date
String
생년월일
pass_code
String
여권 코드
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/ocr_identi3" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/sample_passport.png"
응답 예시

{
    "data": {
        "result": {
            "name": "홍길동",
            "pass_num": "M00000000",
            "made_date": "20230101",
            "exp_date": "20330101",
            "birth_date": "20000101",
            "pass_code": "M000000000KOR0001010M33010101234567V12345678"
        },
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 12,
        "ms": 717,
        "pl_id": 330
    }
}
현재 페이지 북마크