개발 문서

사용량 조회 API

과금과 집계를 외부에서 읽습니다. 사내 BI나 비용 대시보드에 연결할 때 씁니다.

조회 전용 키

서비스 키가 아니라 사용량 조회 키로만 접근합니다. 조직당 세 개까지 발급되고 허용 IP 지정이 필수입니다.

일별 집계와 요청 단위 목록을 나눠 제공합니다. 일별 집계에는 라우팅 결정 요약이 함께 옵니다.

Method	Path	Returns
GET	/usage/daily	Daily totals and routing summary
GET	/usage/requests	Per-request records
GET	/usage/keys	Totals grouped by key

커서 방식입니다. next_cursor가 비면 끝입니다. 한 번에 최대 1000건입니다.

집계는 최대 5분 지연됩니다. 실시간 차단이 필요하면 키 예산 기능을 쓰세요.