공공데이터포털의 개발계정 상세보기 (준비 땅~)

공공데이터포털의 개발계정 상세보기 화면으로, 국세청 사업자등록정보 진위확인 및 상태조회 API에 대한 설명이 담겨 있습니다. 핵심 내용을 요약하면 다음과 같습니다:

📌 기본 정보

• 데이터명: 국세청 사업자등록정보 진위확인 및 상태조회 서비스
• 서비스 유형: REST API
• 호출 제한: 하루 1,000,000회
• 데이터 포맷: JSON, XML 지원
• Base URL: https://api.odcloud.kr/api/nts-businessman/v1
• Swagger 문서: 제공됨 (API 명세 확인 가능)

⚙️ 주요 기능

1. 사업자등록정보 진위확인 API (POST /validate)
   • 사업자등록번호, 대표자 성명, 개업일자 등 필수 항목 입력 필요
   • 외국인 사업자의 경우 영문명/한글명 입력 규칙 존재
   • 응답: 사업자등록정보의 진위 여부 반환
2. 사업자등록 상태조회 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 미니앱에서 사업자번호 검증 기능을 구현할 때 바로 활용할 수 있습니다.