구독 이벤트
구독 이벤트를 구독하면 채널에서 발생하는 구독을 실시간으로 수신합니다.
구독 엔드포인트: POST /api/openapi/open/v1/sessions/events/subscribe/subscription
필요 Scope: READ:SUBSCRIPTION
이벤트 데이터
{
"event": "SUBSCRIPTION",
"data": {
"channelId": "12345",
"subscriberChannelId": "67890",
"subscriberChannelName": "구독자명",
"subscriberBadges": [
{ "id": "subscribe_tier1", "name": "티어1 구독자", "imageUrl": "https://..." }
],
"month": 3,
"tierNo": 1,
"tierName": "입덕",
"subscriptionText": "3개월 구독합니다!",
"emojis": {}
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
channelId |
string | 구독이 발생한 채널의 ID |
subscriberChannelId |
string | null | 구독자의 채널 ID. 익명 구독 시 null |
subscriberChannelName |
string | null | 구독자의 채널 이름. 익명 구독 시 null |
subscriberBadges |
array | 구독자의 뱃지 목록 (없으면 빈 배열). 각 항목은 id, name, imageUrl 포함 |
month |
number | 구독 개월 수 |
tierNo |
number | 구독 티어 번호 (1 또는 2) |
tierName |
string | 구독 브랜드명 |
subscriptionText |
string | 구독 메시지 |
emojis |
object | 이모티콘 토큰과 이미지 URL 매핑 |