Grind away: 여권 텍스트 추출(OCR) API · OCR 자동화 · 호출당 과금 REST API

2026년 4월 22일 수요일

여권 텍스트 추출(OCR) API · OCR 자동화 · 호출당 과금 REST API | APICK 에이픽

APICK · SERVICE BROCHURE · OCR

여권 텍스트 추출(OCR) API

여권 신분면(MRZ 포함)에서 여권번호·이름·국적 등을 추출하는 OCR API

💳 호출당 - ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준

About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트

/rest/ocr_identi3

REST · POST 요청

호출 단가

정책 별도

후불제 정책 별도 · 호출당

응답 시간

api.ms

응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

Method	POST
Endpoint	`https://apick.app/rest/ocr_identi3`
Header	CL_AUTH_KEY(인증키(MD5))
FormData	값: image
Response	data · api 객체
api 객체	success · cost · ms · pl_id
success 값	0 실패 · 1 성공 · 3 타임아웃
응답시간	api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위	- / 호출당

요청 파라미터

이름	타입	필수	설명
`image`	File	필수	여권 이미지 파일

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/ocr_identi3" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "image=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "result": {
      "name": "홍길동",
      "pass_num": "M00000000",
      "made_date": "20230101",
      "exp_date": "20330101",
      "birth_date": "20000101",
      "pass_code": "M000000000KOR0001010M33010101234567V12345678"
    },
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 5,
    "ms": 717,
    "pl_id": 330
  }
}

응답 필드

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

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급

✓선불제 포인트 충전 또는 후불제 약정

✓호출 IP 화이트리스트 설정 검토

✓응답 객체 파싱 및 빈 값 처리 정책 수립

✓타임아웃(35초) 대응 로직 구현

✓api.cost 기반 과금 모니터링 구성

📄 여권 텍스트 추출(OCR) API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
여권 텍스트 추출(OCR) API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #여권텍스트추출(OCR)API

Grind away