공공데이터포털의 개발계정 상세보기 화면으로, 국세청 사업자등록정보 진위확인 및 상태조회 API에 대한 설명이 담겨 있습니다. 핵심 내용을 요약하면 다음과 같습니다:
📌 기본 정보
- 데이터명: 국세청 사업자등록정보 진위확인 및 상태조회 서비스
- 서비스 유형: REST API
- 호출 제한: 하루 1,000,000회
- 데이터 포맷: JSON, XML 지원
- Base URL: https://api.odcloud.kr/api/nts-businessman/v1
- Swagger 문서: 제공됨 (API 명세 확인 가능)
⚙️ 주요 기능
- 사업자등록정보 진위확인 API (POST /validate)
- 사업자등록번호, 대표자 성명, 개업일자 등 필수 항목 입력 필요
- 외국인 사업자의 경우 영문명/한글명 입력 규칙 존재
- 응답: 사업자등록정보의 진위 여부 반환
- 사업자등록 상태조회 API (POST /status)
- 사업자등록번호(10자리 숫자) 필수
- 응답: 등록 상태(정상, 말소, 미등록 등) 반환
📑 요청/응답 규칙
- Request:
- serviceKey와 returnType은 URL querystring에 포함
- 사업자번호(b_no) 등은 JSON body에 포함
- 최대 100개 사업자번호까지 한 번에 조회 가능
- Response:
- JSON 또는 XML 형식
- 오류 발생 시 status code (400, 411, 413, 500)와 에러 메시지 반환
🚨 주의사항
- POST 방식만 지원 (GET 불가)
- 사업자등록번호는 반드시 숫자 10자리, - 제거 후 입력
- 개업일자는 YYYYMMDD 형식으로 입력
- 삭제된 사업자등록정보는 조회 불가
- 100개 초과 요청 시 Too Large Request Error 발생
📖 활용 목적
- 앱 개발 (모바일, 솔루션 등)
- Toss 미니앱에서 사업자번호 조회 서비스 제공 가능
즉, 이 API는 사업자등록번호의 진위 여부와 상태를 확인하는 서비스로, Toss 미니앱에서 사업자번호 검증 기능을 구현할 때 바로 활용할 수 있습니다.
댓글 없음:
댓글 쓰기