2026.10.16 — v1.2.0
DJ 識別子・ギフト履歴 API とフォローイベントを追加し、リスナー一覧にサブスク情報を加えました。
- DJ 識別子を取得 —
GET /v1/meを追加しました。me.read権限が必要で、配信中でなくても使えます。レスポンスのuserIdはイベントストリームのuser.idと同じ値です。 - ギフト履歴を取得 —
GET /v1/live/donationsを追加しました。ボットが止まっていた間のギフトを復旧できます。権限は新規のdonations.readです。 - リスナー一覧を取得 — レスポンスに
subscription({ "plan": "PLAN_1"~"PLAN_3" }、nullはサブスクでない)を追加しました。サブスク会員向けの挨拶・特典ボットが作れます。 - フォローイベント — イベントストリームに
followを追加しました。新しい権限events.followで受け取り、presenceと同じくマネージャー指定が必要です。配信ごと・リスナーごとに最初のフォローだけ届きます。 - トークン — トークンを受け取ったらまず
GET /v1/meでuserIdを保存し、同じ DJ の以前のトークンは失効させる流れを案内します。 - ボットを作る — トークン交換の手順に DJ 識別子の保存案内を追加しました。