↓ donation

후원 데이터를 반환하는 리스너입니다. 별풍선 등의 후원정보가 donation 리스너를 통해 제공됩니다. 특정 후원 타입만 사용하려면 extras.soop.typeName 또는 extras.chzzk.donationType을 기준으로 필터링하세요. extras의 다른 원본 필드는 제공하지 않습니다.

지원되는 후원종류

도전미션·대결미션은 v2.0 부터 mission 리스너 로 분리되어 들어옵니다.

플랫폼	후원종류	typeName / donationType	비고
숲	별풍선	`SVC_SENDBALLOON` (18)
숲	영상 풍선	`SVC_VIDEOBALLOON` (105)	v2.0 신규
숲	애드벌룬	`SVC_ADCON_EFFECT` (87)
치지직	채팅방 내 치즈 후원	`donationType: CHAT`
치지직	영상 후원	`donationType: VIDEO`	`extras.chzzk.donationType` 로 구분
치지직	파티 후원	`donationType: PARTY`	`extras.chzzk.donationType` 로 구분

정식 지원 범위 밖의 원본 필드는 API·Socket payload로 제공되지 않습니다. 장애 분석을 위해 별도로 수집되는 RAW 데이터도 최대 7일만 보관됩니다.

Response

Donation 스키마를 참고하세요.

Response Fields

필드	타입	설명
_id	string	후원 고유 ID
platform	string	플랫폼
type	string	후원 타입
streamer_id	string	스트리머 ID
user_id	string	후원자 ID
nickname	string	후원자 닉네임
cnt	number	후원 수량
message	string	후원 메시지
amount	number	후원 금액
extras	object	후원 유형 정보만 포함 (`soop.typeName` 또는 `chzzk.donationType`)

Example Response

{
  "_id": "661a997508d233b41860fb90",
  "platform": "soop",
  "type": "donation",
  "streamer_id": "string",
  "user_id": "string",
  "nickname": "string",
  "cnt": 50,
  "message": "",
  "amount": 5000,
  "extras": {
    "soop": {
      "typeName": "SVC_SENDBALLOON"
    }
  }
}

지원되는 후원종류​

Response​

Response Fields​

Example Response​

지원되는 후원종류

Response

Response Fields

Example Response