후원 이벤트
후원 이벤트를 구독하면 채널에서 발생하는 후원을 실시간으로 수신합니다. 채팅 후원(CHAT)과 영상 후원(VIDEO)을 지원합니다.
구독 엔드포인트: POST /api/openapi/open/v1/sessions/events/subscribe/donation
필요 Scope: READ:DONATION
이벤트 데이터
{
"event": "DONATION",
"data": {
"donationType": "CHAT",
"channelId": "12345",
"donatorChannelId": "67890",
"donatorNickname": "후원자명",
"payAmount": "10000",
"donationText": "응원합니다!",
"emojis": {}
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
donationType |
string | "CHAT" (채팅 후원) 또는 "VIDEO" (영상 후원) |
channelId |
string | 후원이 발생한 채널의 ID |
donatorChannelId |
string | null | 후원자의 채널 ID. 익명 후원 시 null |
donatorNickname |
string | null | 후원자 닉네임. 익명 후원 시 null |
payAmount |
string | 후원 금액 (빔 단위) |
donationText |
string | 후원 메시지 |
emojis |
object | 이모티콘 토큰과 이미지 URL 매핑 |
미션 후원, 응원 후원 이벤트는 현재 지원하지 않습니다.