API REFERENCE

키 상태 확인

내 API 키가 살아있는지, 현재 어떤 플랜인지, 오늘 몇 번 호출했는지 한 번에 확인할 수 있어요. 키 발급 직후 동작 확인용으로 가장 먼저 호출하는 엔드포인트예요.

요청

http

GET /api/public/v2/health HTTP/1.1
Host: www.bulliza.com
Authorization: Bearer rfk_live_<your-key>

파라미터

이 엔드포인트는 추가 파라미터가 없어요.

응답

필드	타입	설명
`ok`	boolean	항상 true. false 이면 인증 실패라 401 로 받아요
`plan`	string	`free` \| `paid` \| `admin` — 현재 사용자의 플랜
`daily_limit`	number	일일 호출 한도 (free = 1,000)
`rpm_limit`	number	분당 호출 한도 (free = 30)
`req_count_today`	number	오늘(KST 기준) 호출한 횟수
`time`	ISO 8601	서버 응답 시각

json

{
  "ok": true,
  "plan": "free",
  "daily_limit": 1000,
  "rpm_limit": 30,
  "req_count_today": 1,
  "time": "2026-06-15T13:42:01.234Z"
}

호출 예시

bash

curl -H "Authorization: Bearer rfk_live_<your-key>" \
  https://bulliza.com/api/public/v2/health

javascript

const r = await fetch("https://bulliza.com/api/public/v2/health", {
  headers: { Authorization: `Bearer ${process.env.RICHGO_API_KEY}` },
});
const { plan, daily_limit, req_count_today } = await r.json();
console.log(`${plan} 플랜 · 오늘 ${req_count_today}/${daily_limit}`);

다음 단계