API 레퍼런스 | Spoon Developers

📄️엔드포인트 목록

봇이 호출할 수 있는 엔드포인트를 메서드·경로·필요한 권한과 함께 한 표에 모았어요.

access token 을 발급·갱신·폐기하는 OAuth 엔드포인트 명세예요.

GET /v1/live — 방송 제목 · 시작/종료 시각 · 청취자 수 · 채팅 얼림 상태를 조회해요.

GET /v1/live/listeners — 지금 방에 있는 청취자의 id 와 닉네임을 커서로 나눠 조회해요.

GET /v1/live/fans — 지금 방에 있는 청취자의 이 방송 후원 랭킹 상위 30명을 조회해요.

GET /v1/live/events — 채팅 · 입장 · 하트 · 후원을 SSE 로 실시간으로 받아요. 이벤트 5종의 페이로드 명세예요.

POST /v1/live/chat — 봇 계정 이름으로 방송에 채팅을 보내요.

봇 API 의 에러 응답 형식과 봇이 실제로 마주치는 코드별 대처 방법이에요.