개발자 API

키 발급, 인증 정책, 요청 제한을 미리 정리합니다.

이 문서는 Hubble-search 개발자 API 셀프서비스를 기준으로 인증 흐름과 현재 정책을 설명하는 문서 허브입니다.

문서 허브 · 내 API 키 관리로 이동

인증 방식

모든 요청은 발급된 API key를 Authorization 헤더에 붙여 전송하는 형태로 설계합니다. 생성 직후 한 번만 평문 키를 보여주고 이후에는 마스킹된 값만 유지합니다.

요청 제한

현재 free 플랜은 분당 30회, premium 플랜은 분당 120회 수준의 제한을 기준으로 정책을 설계합니다. 실제 사용량 대시보드는 프리뷰 수치로 표시됩니다.

엔드포인트 티어

Auction Search Basic은 검색과 인사이트 개요 중심이며, 향후 premium 티어에서 고급 필터와 확장 지표를 순차 개방할 계획입니다.

현재 범위
  • 키 생성 직후 평문은 한 번만 노출되며 다시 복구할 수 없습니다.
  • Webhook, usage billing, 팀 단위 key sharing은 Q2 후속 범위입니다.
  • 현재 문서와 대시보드는 백엔드 연동 전 프리뷰 흐름을 설명합니다.