개발가이드

  • 개발가이드

여권 개인정보 마스킹

여권의 지정 정보를 추출하고 여권번호 및 MRZ 영역을 마스킹합니다.

정보

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

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
image
File
O
20MB 이하 PNG 또는 JPEG 여권 인적사항면 이미지

응답

필수 정보 또는 여권번호·MRZ 마스킹 위치를 확정하지 못하면 무과금 실패하며 이미지와 부분 추출값을 반환하지 않습니다.

Body
이름
타입
설명
data.result.document_type
String
passport
data.result.fields.country_code
String
발행국 코드
data.result.fields.surname
String
성
data.result.fields.given_names
String
이름
data.result.fields.korean_name
String
한글 성명
data.result.fields.date_of_birth
String
생년월일(YYYYMMDD)
data.result.fields.sex
String
성별(M/F/X)
data.result.fields.nationality
String
국적
data.result.masked_image
String
여권번호와 MRZ 두 줄을 가린 PNG의 Base64 데이터
data.result.image_mime
String
image/png
data.result.elapsed_ms
Integer
OCR·추출·마스킹 처리 시간(ms)
data.success
Integer
과금 여부(0: 실패, 1: 성공)
api
Object
API 호출 공통 데이터

예시

요청 예시

curl -k -X POST "https://apick.app/rest/identity_document_passport" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/passport.jpg"
마스킹 이미지 저장 예시(Node.js)

const response = await fetch(url, options);
const body = await response.json();
require("fs").writeFileSync("masked.png", Buffer.from(body.data.result.masked_image, "base64"));
현재 페이지 북마크