Spoon Developers CHANGELOG

2026.10.16 — v1.2.0

Fri, 16 Oct 2026 00:00:00 GMT

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

Wed, 14 Oct 2026 00:00:00 GMT

DJ をフォローする API を追加し、イベントストリームのマネージャー反映と接続ルールを変更しました。ボットの再接続とマネージャー指定の案内も補強しました。

DJ をフォロー — POST /v1/live/follow を追加しました。新しい権限 dj.follow が必要で、ボットを固定マネージャーにする前にボットアカウントが DJ をフォローするときに使います。
イベントストリーム — 再接続だけでは入場メッセージが再表示されないこと、再表示される 2 つのケースをまとめました。
イベントストリーム — 常駐ボットが 1 時間ごとに TOKEN_EXPIRED を受け取る理由と再接続の方法を記載しました。
イベントストリーム — この配信のマネージャーに指定・解除すると、接続し直さなくても数秒以内に反映されます。
イベントストリーム — 同じアプリは DJ ひとりにつき接続をひとつだけ維持します。新しい接続が入ると、前の接続は end DUPLICATE_CONNECTION で閉じます。
マネージャー指定 — ボットを固定マネージャーに指定する順番(配信中にフォロー → 配信終了後に指定)を案内します。
トークン — 推奨の更新タイミングを有効期限の 5 分前に変更しました。
エラーコード — OAPI_MNGR_0211 を追加しました。

Wed, 30 Sep 2026 00:00:00 GMT

Spoon 開発者センターを正式に公開しました。