외국인등록증·영주증·외국국적동포 국내거소신고증의 지정 정보를 추출하고 등록번호 또는 거소신고번호 뒷자리 6자리를 마스킹합니다.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.
실패 응답은 data.success: 0, api.cost: 0을 유지하며 data.error_code로 원인을 구분합니다.
curl -k -X POST "https://apick.app/rest/identity_document_residence_card" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "image=@/C:/Users/user/Desktop/residence_card.jpg"
마스킹 이미지 저장 (Node.js)
const form = new FormData();
form.append("image", new Blob([fs.readFileSync("residence_card.jpg")]), "residence_card.jpg");
const response = await fetch("https://apick.app/rest/identity_document_residence_card", {
method: "POST",
headers: { CL_AUTH_KEY: process.env.API_KEY },
body: form,
});
const body = await response.json();
if (body.data.success === 1) {
console.log(body.data.result.fields);
fs.writeFileSync("masked.png", Buffer.from(body.data.result.masked_image, "base64"));
} else {
console.error(body.data.error);
}
{
"data": {
"result": {
"document_type": "residence_card",
"fields": {
"registration_number_front": "900101",
"registration_number_back_first": "5",
"name": "JOHN SMITH",
"country_region": "UNITED STATES",
"residence_status": "거주(F-2)"
},
"masked_image": "iVBORw0KGgoAAAANSUhEUgAA...(생략)",
"image_mime": "image/png",
"elapsed_ms": 644
},
"success": 1
},
"api": {
"success": true,
"cost": 30,
"ms": 780,
"pl_id": 1595641
}
}