API 레퍼런스 | Spoon Developers

📄️엔드포인트 목록

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

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

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

GET /v1/live/listeners — 지금 방에 있는 청취자의 id · 닉네임 · 구독 여부를 커서로 나눠 조회해요.

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

GET /v1/live/donations — 현재 방송에서 받은 후원 스티커 내역을 커서로 나눠 조회해요.

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

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

POST /v1/live/follow — 봇 계정으로 연동한 DJ 를 팔로우해요. 봇을 고정 매니저로 받으려면 먼저 필요해요.

GET /v1/me — 이 토큰이 가리키는 DJ 의 식별자를 조회해요. 방송 중이 아니어도 돼요.

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