メインコンテンツまでスキップ

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 識別子の保存案内を追加しました。