Discord連携API

Discord連携APIでは、Discordサーバー（Guild）に対してロール（Role）やチャンネル（Channel）の作成・更新・取得・削除ができます。

共通：認証（必須）

すべてのリクエストで、アクセストークンをHTTPヘッダーに付与してください。
アクセストークンの取得方法は「API設定方法」をご確認ください。

Authorization: Bearer {access_token}

ロールAPI（Role）

ロールの作成・更新・取得・削除を行います。

ロール作成

POST /v1/discord/guilds/{guild_id}/roles

・リクエスト（JSON）

{
  "name": "ロール名",
  "position": 1,
  "permissions": ["VIEW_CHANNEL", "SEND_MESSAGES"]
}

ロール更新

PUT /v1/discord/guilds/{guild_id}/roles/{role_id}

ロール取得

GET /v1/discord/guilds/{guild_id}/roles/{role_id}

ロール削除

DELETE /v1/discord/guilds/{guild_id}/roles/{role_id}

レスポンスはDiscordのRole Object形式です（Discord側の仕様に準拠します）。

チャンネルAPI（Channel）

チャンネルの作成・更新・取得・削除を行います。

チャンネル作成

POST /v1/discord/guilds/{guild_id}/channels

・リクエスト（JSON）

{
  "type": 0,
  "name": "example-channel",
  "topic": "チャンネル説明（任意）",
  "role": [
    {
      "id": "ROLE_ID",
      "allow": ["VIEW_CHANNEL"],
      "deny": []
    }
  ],
  "user": [
    {
      "id": "USER_ID",
      "allow": ["VIEW_CHANNEL", "SEND_MESSAGES"],
      "deny": []
    }
  ]
}

チャンネル更新 / 取得 / 削除

PUT    /v1/discord/guilds/{guild_id}/channels/{channel_id}
GET    /v1/discord/guilds/{guild_id}/channels/{channel_id}
DELETE /v1/discord/guilds/{guild_id}/channels/{channel_id}

Permissionオブジェクト（role / user で使用）

{
  "id": "ロールIDまたはユーザーID",
  "allow": ["許可する権限名（任意）"],
  "deny": ["禁止する権限名（任意）"]
}

以上