Voicedevelopers
Консоль
Справочник API

Серверы — API

Сведения о сервере доступны его участникам — в том числе боту, которого добавили.

GET/api/servers/:serverId

Сервер целиком

Bot

Сервер, категории и каналы, которые видит бот, роли, участники и кто сидит в голосовых каналах.

JSON
{
  "server": { "id": "s_…", "name": "Кофейня", "icon": null, "ownerId": "u_…", "permissions": "117824", "memberCount": 42,
              "defaultChannelId": "c_…", "systemChannelId": "c_…", "createdAt": 1767225600000, … },
  "categories": [{ "id": "cat_…", "serverId": "s_…", "name": "Общее", "position": 0 }],
  "channels": [{ "id": "c_…", "serverId": "s_…", "categoryId": "cat_…", "name": "общий", "type": "text",
                 "topic": null, "position": 0, "nsfw": false, "slowmode": 0, … }],
  "roles": [{ "id": "r_…", "name": "@everyone", "color": null, "position": 0, "permissions": "…", "mentionable": true, "hoist": false }],
  "members": [{ "userId": "u_…", "nickname": null, "joinedAt": 1767225600000, "roleIds": ["r_…"], "hoistedRoleId": null,
                "user": { "id": "u_…", "username": "alice", … } }],
  "voiceOccupancy": [{ "roomId": "c_…", "members": ["u_…"] }]
}

server.permissions — права бота на сервере (без учёта настроек каналов). Типы каналов: text, voice, announcement, stage и др. 403 — бот не участник.

GET/api/servers/:serverId/roles

Роли сервера

Bot
JSON
{ "roles": [{ "id": "r_…", "serverId": "s_…", "name": "Модераторы", "color": "#5865f2", "badge": null, "position": 3, "permissions": "8192", "mentionable": true, "hoist": true }], "canManage": false }
Изменения на серверах (новые каналы, роли, участники) приходят событиями шлюза — см. События. Повторно запрашивать сервер не нужно.
НазадПользователиДальше Сообщения