개발자용 API
사업자등록번호 하나로 상호·대표자·사업자 상태(계속·휴업·폐업)·과세유형·업종·주소를 JSON으로 받습니다. 회원가입·거래처 등록·정산 화면에 바로 연결하세요.
서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.
인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.
curl -X POST "https://apick.app/rest/biz_detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--form-string "biz_no=1234567890"
const form = new FormData();
form.append("biz_no", "1234567890");
const response = await fetch("https://apick.app/rest/biz_detail", {
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": {
"회사명": "주식회사 예시상사",
"사업자등록번호": "1234567890",
"사업자상태": "계속사업자",
"과세유형": "부가가치세 일반과세자",
"폐업일": "",
"대표명": "홍길동",
"설립일": "2018-03-02",
"업종": "정보통신업",
"업태": "응용 소프트웨어 개발 및 공급업",
"도로명주소": "서울특별시 중구 세종대로 110",
"사업자상태코드": "01",
"과세유형코드": "01",
"success": 1
},
"api": {
"success": true,
"cost": 50,
"ms": 210
}
}
예시 값은 가상의 사업자입니다. 전체 응답 항목은 개발 문서에 있습니다.
HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.
data.success = 0HTTP 200조회에 실패했습니다. data.error의 문구를 확인하세요. 과금되지 않습니다.
data.success = 3HTTP 200처리 시간이 초과됐습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다.
유효하지 않은 API키 입니다.HTTP 401Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.
허용되지 않은 IP주소 입니다.HTTP 401마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.
사용 가능한 포인트이 부족합니다.HTTP 200HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
전체 응답 항목과 오류 코드는 개발 문서에 있습니다.