사업자 정보 조회 API
사업자등록번호 하나로 회사명·대표자·주소·업종·세무·통신판매업까지 한 번의 호출로 받아오는 기업 신원 확인
APICK 은 어떤 서비스인가요?
APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지
80여 종의 비즈니스 API 를 REST 표준으로 제공하는
호출당 과금 플랫폼 입니다.
단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고,
월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.
- ✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
- ✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
- ✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록
왜 APICK 인가 · 3가지 핵심 강점
01 정찰제 · 투명 가격모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다. | 02 가입 즉시 전체 사용회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다. | 03 5분 연동 · 무심사별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다. |
주요 서비스 분야
01 금융·계좌 인증계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일 | 02 사업자·기업사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태 |
03 부동산·등기건축물대장 · 인터넷등기소 · 토지대장 · 공시지가 | 04 개인·신분증 인증주민번호 진위 · 신분증 OCR·진위 · 개인통관부호 |
05 이미지·영상·음성얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환 | 06 웹·문서·주소·검색구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명 |
한눈에 보는 연동 사양
|
엔드포인트
/rest/biz_detailREST · POST 요청
|
호출 단가
정책 별도
후불제 정책 별도 · 호출당
|
응답 시간
api.ms응답 본문 api.ms 값으로 확인
|
핵심 특장점 · 빠른 도입 포인트
연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.
01 최소 입력 · 즉시 응답필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다. | 02 표준 인증 방식CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다. |
03 호출 메타 자동 제공응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다. | 04 투명한 과금선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다. |
05 단순 REST 인터페이스표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다. | 06 실패 응답 처리data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다. |
도입 효과
호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.
✅ 호출 메타 자동 제공api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다. | ✅ 표준 REST 인터페이스단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다. | ✅ 실시간 응답평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다. |
연동 사양 요약
| Method | POST |
|---|---|
| Endpoint | https://apick.app/rest/biz_detail |
| Header | CL_AUTH_KEY(인증키(MD5)) |
| FormData | 값: biz_no |
| Response | data · api 객체 |
| api 객체 | success · cost · ms · pl_id |
| success 값 | 0 실패 · 1 성공 · 3 타임아웃 |
| 응답시간 | api.ms 값으로 확인 · 네트워크 상황에 따라 변동 |
| 과금 단위 | - / 호출당 |
요청 파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
biz_no | String | 필수 | 사업자등록번호 |
요청 예시 · cURL
공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.
curl -k -X POST "https://apick.app/rest/biz_detail" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "biz_no=sample"
응답 예시 · JSON 샘플
표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.
{
"data": {
"회사명": "주식회사 에이픽",
"사업자등록번호": "4398700761",
"법인등록번호": "135811-0317959",
"통신판매업번호": "2024-서울금천-0123",
"사업자상태": "계속사업자",
"과세유형": "부가가치세 일반과세자",
"대표명": "김찬우",
"설립일": "2017-06-07",
"업종": "정보통신업",
"업태": "시스템 소프트웨어 개발 및 공급업",
"전화번호": "02-1234-5678",
"우편번호": "08505",
"지번주소": "서울특별시 금천구 가산동 371-49",
"도로명주소": "서울특별시 금천구 가산디지털2로 101, 15층(가산동)",
"직원수": "12",
"통판_운영상태": "영업중",
"통판_대표자명": "김찬우",
"success": 1
},
"api": {
"success": true,
"cost": 40,
"ms": 206,
"pl_id": 9734570
}
}
응답 필드
| 경로 | 타입 | 설명 |
|---|---|---|
data.회사명 | String | 회사명 |
data.사업자등록번호 | String | 사업자등록번호 |
data.법인등록번호 | String | 법인등록번호 |
data.통신판매업번호 | String | 통신판매업번호 |
data.사업자상태 | String | 계속사업자, 휴업자, 폐업자 |
data.과세유형 | String | 부가가치세 유형 또는 기타 과세 유형 |
data.폐업일 | String | 폐업일 |
data.대표명 | String | 대표명 |
data.설립일 | String | 설립일 |
data.업종 | String | 업종 |
data.업태 | String | 업태 |
data.종목 | String | 종목 |
data.전화번호 | String | 전화번호 |
data.팩스번호 | String | 팩스번호 |
data.직원수 | String | 직원수 |
data.우편번호 | String | 우편번호 |
data.지번주소 | String | 지번주소 |
data.도로명주소 | String | 도로명주소 |
data.위도 | String | 위도 |
data.경도 | String | 경도 |
data.사업자상태코드 | String | 01: 계속, 02: 휴업, 03: 폐업 |
data.과세유형코드 | String | 과세유형코드 |
data.통판_운영상태 | String | 통신판매업 운영상태 |
data.통판_사업자구분 | String | 법인/개인 구분 |
data.통판_법인명 | String | 통신판매업 신고 법인명 |
data.통판_대표자명 | String | 통신판매업 대표자명 |
data.통판_대표자이메일 | String | 대표자 이메일 |
data.통판_도메인 | String | 인터넷 판매 도메인 |
data.통판_취급품목 | String | 판매 취급품목 |
data.success | Integer | 0: 실패, 1: 성공, 3: 실패(timeout) |
api.success | Boolean | API 서버 정상 응답 여부 |
api.cost | Integer | API 호출 요금 |
api.ms | Integer | API 응답 시간 |
api.pl_id | Integer | API 결제 로그 ID |
도입 체크리스트
연동 작업 전 확인이 필요한 항목
지금 바로 APICK 에 연동해보세요
회원가입 즉시 CL_AUTH_KEY 발급.
사업자 정보 조회 API 는 호출당 정책 별도,
월 최소 비용 없이 호출한 만큼만 과금됩니다.
* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.
#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #사업자정보조회API #사업자API #기업정보API #B2B검증
댓글 없음:
댓글 쓰기