변경 내역

이제 webhook 전송에 x-roomscope-signature, x-roomscope-timestamp, x-roomscope-alert-id, x-roomscope-schema-version 헤더가 포함됩니다. 서명 방식과 페이로드는 바뀌지 않았으며, 검증할 때 새 헤더 이름을 읽으세요.

오류, 크레딧, 속도 제한, 인증, Webhook 문서가 이제 실제 동작을 설명합니다: 실제 오류 코드, X-RateLimit 헤더를 사용하는 key별 속도 제한, 크레딧 비용과 월간 제공량, 서명된 webhook 방식. 레퍼런스에 크리에이터 인사이트, 최적 방송 시간, LIVE 현황이 추가되었습니다. 문서 검색이 활성화되었습니다(⌘K).

시작하기, 인증, 오류, 속도 제한, 랭킹 레퍼런스, Webhook. 나머지 리소스의 레퍼런스 페이지는 OpenAPI 문서에서 생성되는 대로 추가됩니다.

이제 모든 오류가 { code, message, requestId, retryable }을 반환합니다. 클라이언트는 code로 분기하고 retryable이 true일 때만 재시도해야 합니다.

GET /v1/rankings/official이 data 옆에 provenance 객체(coverageStatus, observedAt)를 반환합니다.

key에 명시적인 스코프(rank:read, live:read, creator:read, …)가 지정됩니다. key의 스코프를 벗어난 요청은 403 insufficient_scope로 실패합니다.