공지사항
Spoon Developers 신규 API 및 API 스펙 업데이트 안내
안녕하세요. 스푼 운영팀입니다.
개발자 여러분의 의견을 반영하여 Spoon Developers의 신규 API와 API 스펙을 업데이트했습니다. 특히 가장 많은 요청을 받았던 후원 내역, 구독 정보, 팔로우 이벤트 관련 기능이 추가되었습니다.
1. 후원 내역 조회 API 추가
현재 방송에서 발생한 후원 내역을 조회할 수 있는 GET /v1/live/donations API를 추가했습니다.
- 필요한 권한: donations.read
- 제공 정보: 후원자 식별자와 닉네임, 스티커 이름, 후원한 spoon 수, 후원 시각
- 커서 기반 페이지네이션 지원
현재 방송의 후원 내역만 조회할 수 있으며 방송 종료 후에는 조회할 수 없습니다. 후원 메시지와 스티커 이미지 URL은 응답에 포함되지 않습니다.
2. 청취자 목록에 구독 정보 추가
GET /v1/live/listeners 응답에 subscription 필드를 추가했습니다.
- 필요한 권한: listeners.read
- 구독 중인 경우: subscription.plan에 PLAN_1, PLAN_2, PLAN_3 중 하나가 전달됩니다.
- 구독하지 않은 경우: subscription이 null로 전달됩니다.
3. 팔로우 이벤트 추가
이벤트 스트림에 follow 이벤트를 추가했습니다.
- 필요한 권한: events.follow
- 방송 중 청취자가 DJ를 처음 팔로우했을 때 전달됩니다.
- 봇 계정이 해당 방송의 매니저로 지정되어 있어야 합니다.
방송 밖에서 발생한 팔로우와 같은 방송에서의 재팔로우는 전달되지 않습니다.
4. DJ 식별자 조회 API 추가
동의한 DJ의 고유 식별자를 조회할 수 있는 GET /v1/me API를 추가했습니다.
- 필요한 권한: me.read
방송 여부와 관계없이 호출할 수 있습니다.
응답의 userId는 DJ가 이벤트 스트림에서 채팅했을 때 전달되는 user.id와 동일합니다.
적용 전 확인 사항
donations.read, events.follow, me.read는 새롭게 추가된 권한입니다. 기존 앱에서 해당 기능을 사용하려면 개발자 센터에서 필요한 권한을 추가한 후 DJ에게 다시 동의를 받아야 합니다.
자세한 요청·응답 스펙과 구현 예시는 v1.2.0 변경 내역에서 확인해 주세요.
앞으로도 개발자 여러분의 의견을 바탕으로 Spoon Developers의 기능과 문서를 지속적으로 개선하겠습니다.
감사합니다.
Spoon 운영팀