アプリ登録
このガイドに沿って進めると、Spoon 開発者センターにアプリを登録し、API 連携に必要な Client ID と Client Secret を受け取れます。
用意するもの
- Spoon アカウント — アプリはログインした Spoon アカウントの所有として登録されます。
- ログインリダイレクト URL — ユーザーが Spoon ログインを終えた後に戻る、あなたのサービスのアドレスです。
アプリを登録した Spoon アカウントがボットアカウントになります。ボットはこのアカウント名でチャットし、リスナーへの告知を送ります。 DJ 本人のアカウントで登録すると、その DJ の配信には連携できません — 同意画面で「連携できないアプリ」と表示されて終わります。 ボット専用の Spoon アカウントを別に作って登録してください。
ボットアカウントで Spoon アプリ・ウェブにログインすること自体は問題ありません。固定マネージャーに必要なフォローもアプリで直接できます。 DJ をフォロー API でもできます。 別の配信にアプリ・ウェブで入ってもボットに影響はありません。問題になるのは、ボットが接続している同じ配信に同じアカウントで入る場合だけです。 そのアプリ・ウェブの接続が切れるとボットも部屋から抜けて、入場メッセージがもう一度表示されます。
1. 開発者センターのコンソールを開く
Spoon 開発者センターにログインし、コンソールへ移動します。
2. 新しいアプリを登録する
コンソールで [アプリ登録] を押し、4 つの項目を入力します。
| 項目 | ルール |
|---|---|
| アプリ名 | ハングル・日本語・英字・数字・スペースのみで 50 文字以内で入力します。公式サービスとの混同を避けるため、「spoon」(大文字小文字を問わず)、「스푼」または「スプーン」を含む名前は使えません。他のアプリと重複すると登録できないため、入力中に重複チェックが行われます。 |
| ログインリダイレクト URL | https:// の URL のみ登録できます。開発中は http://localhost(ポート付き)も許可されます。 |
| アプリの目的 | このアプリが Spoon API で何をするのかを 200 文字以内で記載します。 |
| API 権限(scopes) | アプリが使う権限をカタログから選びます。カタログは審査ポリシーにより変わることがあります。 |
5 個を超えて登録すると 429 (OAPI_CNSL_0005) で登録が拒否されます。
使っていないアプリを削除してから再度お試しください。
3. 審査結果を待つ
登録したアプリはすぐに使えるわけではなく、審査待ち の状態に入ります。承認されると、 アプリ詳細画面で 2 つの資格情報を確認できます。
| 資格情報 | 性質 |
|---|---|
| Client ID | アプリを示す固有の値です。変わりません。 |
| Client Secret | サーバーでのみ使う秘密の値です。承認後に [表示] を押して確認します。 |
審査待ち・却下の状態で [表示] や [再発行] を押すと 403 (OAPI_CNSL_0006) です。
却下された場合はアプリ詳細に理由が表示されます。内容を修正して保存すると、再び審査待ちになります。
ブラウザのコードやモバイルアプリの配布物に Client Secret を含めると、誰でも取り出せます。 漏えいが疑われる場合は、アプリ詳細で [再発行] を押してください。再発行した瞬間に 既存の Secret は直ちに失効し、その Secret を使う連携は停止します。
次のステップ
発行された Client ID で DJ の同意を得ます。同意が終わったら、
受け取った code で トークンを発行します。