#開発者

Disbandの上に構築します。ボット、統合、および外部からスペースと対話するツールです。ここにあるすべてはセルフホストされています。Disbandは決してコードを実行しません。

#あなたが構築できるもの

• ボット — メッセージを読み書きし、チャネルを管理するセルフホストアカウント。 そして、長期間のポーリングゲートウェイを介してイベントに反応します。 ボットを参照してください。
• Webhooks — ボットなしで秘密のURLを介して投稿された一方通行の通知 コードまたはトークン。Webhookを参照してください。
• 埋め込みカード — 構造化されたリリースノート、アラート、ステータス更新。 埋め込みを参照してください。
• カスタムクライアント — 必要な言語が必要な場合は、HTTP APIに直接ご連絡ください。 出荷されたクライアントはカバーされません。APIリファレンスは 契約書。
• ステータス統合 - RSSを介してDisbandのインシデントをフォローするか、どのように行うかを読んでください。 ステータスシステムはチェックを記録し、インシデントを開きます。

#ここから始めましょう

1. はじめに — ボットを作成し、その トークン、それをスペースに招待します。約2分です。
2. 独自のボットをホストする — 実行場所 クライアントとそれを生き続ける方法。
3. **JavaScript**または Python。
4. **APIリファレンス**は、正確なエンドポイントです。
5. Webhook または 埋め込み が必要な場合は 一方通行の通知。
6. **ステータスシステム**は、公開ステータスページとRSSフィードに使用されます。

#Disbandをゲームやアプリに実装する

Disbandは、ボットトークンで認証されたプレーンHTTP APIを公開しています。ネイティブのSDKやRPCランタイムはありませんが、HTTPSリクエストを実行できるスタックはすべて機能します。典型的な統合は次のようになります。

1. 設定→ボットでボットを作成し、messages.writeを割り当てます（および channels.manageはチャンネルを作成する必要がある場合）。

2. 投稿したいスペースにボットを招待します。

3. トークンをゲームまたはアプリの秘密ストアに保存します。クライアント側には保存しないでください。 プレイヤーに送信されるコード。

4. バックエンドから、スコープされたエンドポイントに呼び出します。

   curl -X POST https://www.disband.dev/api/v1/channels/CHANNEL_ID/messages \
     -H "Authorization: Bot $DISBAND_BOT_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"content": "Server restarted — 12 players online."}'
   

5. ゲーム内からのチャットに反応するには、ゲートウェイを長時間ポーリングして送信します。 messageCreateイベントをゲームロジックに追加します。

#セキュリティノート

• ボットトークンは休止時にハッシュされ、一度だけ表示されます。 1 つがある場合はすぐに取り消してください。 漏れ。
• トークンを管理するサーバーに保管します。ゲームクライアントでトークンを送信すると、 誰かがあなたのボットを偽装する。
• ボットを必要な最小限の特権に制限します。投稿専用ボットは必要ありません members.readまたはchannels.manage。

#開発者向けのテーマ

ブランド化されたクライアントまたはスキンを作成している場合は、テーマのCSS変数は、安定したスタイリングAPIです。

#質問

• バグレポート：問題を開いたり、チームにメールを送ったりします。
• アカウント固有の問題については、アプリ内のサポートを使用してください。