연동 안내
모든 요청은 HTTPS와 JSON을 사용합니다. 발급받은 clientId·clientSecret은 서버 환경변수나 비밀 저장소에서 읽고, 브라우저 코드·공개 저장소·로그에 넣지 마세요.
연동 순서
- 가격 정책과 운영 정책을 확인한 뒤 API 사용신청을 합니다.
- 인증토큰 생성 페이지의 요청 명세에 따라 clientId·clientSecret으로 인증토큰을 발급받습니다.
- 각 API 페이지에서 요청·응답 필드, 입력 제한과 호출 예시를 확인합니다.
- 발급받은 인증토큰을
Authorization: Bearer <token>헤더에 전달해 필요한 API를 호출합니다. - HTTP 오류와 개별 조회 오류를 구분해 처리합니다. 자세한 처리 기준은 오류 처리를 참고하세요.
API별 명세와 예시
각 API 페이지에서 연동에 필요한 명세와 예시를 확인하세요.
| API | 목적 | 주요 반환 정보 |
|---|---|---|
| 인증토큰 생성 | API 호출에 사용할 인증토큰 발급 | 인증토큰 |
| 사업자 기본정보 | 사업자등록번호로 기본정보 확인 | 상호·대표자명·주소·영업상태·과세유형 |
| 사업자 전체정보 | 기본정보에 개업·업종·법인정보 추가 | 기본정보와 개업일·업태·종목·법인등록번호·전화번호 등 |
| 사업자 검색 | 상호·대표자명으로 사업자 찾기 | 사업자등록번호·상호·대표자명·부분 주소 |