개발자용 API
사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 사진을 보내면 등록번호·상호·대표자·주소·발급일을 항목별로 나눠 주고, 등록번호 검증과 지금 영업 중인지(계속·휴업·폐업)까지 함께 알려줍니다.
서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.
인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.
curl -X POST "https://apick.app/rest/business_doc_ocr" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@./business_registration.jpg" \
--form-string "check_status=1"
import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("./business_registration.jpg")]), "business_registration.jpg");
form.append("check_status", "1");
const response = await fetch("https://apick.app/rest/business_doc_ocr", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
body: form,
});
const { data, api } = await response.json();
if (data.error) throw new Error(data.error); // 실패는 과금되지 않습니다
console.log(data, api.cost);
{
"data": {
"doc_type": "사업자등록증",
"fields": {
"사업자등록번호": "123-45-67891",
"과세유형": "일반과세자",
"상호": "에이픽상회",
"대표자": "홍길동",
"개업연월일": "2021-06-01",
"사업장소재지": "서울특별시 강남구 테헤란로 100, 5층",
"업태": "도매 및 소매업",
"종목": "전자상거래 소매업"
},
"checks": {
"사업자등록번호_형식": true,
"사업자등록번호_검증숫자": true,
"문서종류_일치": true
},
"missing": [],
"business_kind": "개인",
"status": {
"조회결과": "확인",
"사업자상태": "계속사업자",
"과세유형": "부가가치세 일반과세자",
"폐업일": ""
},
"success": 1
},
"api": {
"success": true,
"cost": 20,
"ms": 2310
}
}
예시 값은 가상의 사업자입니다. 항목 일부만 보였습니다. 전체 항목은 개발 문서에 있습니다.
HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.
이미지에서 글자를 읽지 못했습니다.HTTP 422서류 전체가 밝고 반듯하게 나오도록 다시 찍게 하세요. 과금되지 않습니다.
사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서를 찾지 못했습니다.HTTP 422다른 서류이거나 일부만 찍힌 사진입니다. 과금되지 않습니다.
무료 포인트로 사용할 수 없는 서비스입니다.HTTP 200최소 1회 충전(결제) 후 이용할 수 있는 API입니다. 충전 후 같은 요청을 다시 보내세요.
유효하지 않은 API키 입니다.HTTP 401Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.
허용되지 않은 IP주소 입니다.HTTP 401마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.
사용 가능한 포인트이 부족합니다.HTTP 200HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
전체 응답 항목과 오류 코드는 개발 문서에 있습니다.