Пользователи

Объект User — базовая сущность, которую бот встречает везде: авторы сообщений, участники гильдий, адресаты DM. Плюс бот сам является User’ом с bot: true.

Объект User (то что видит бот)

{
  "id": "1496956937664585746",
  "username": "my_bot",
  "global_name": null,
  "avatar": null,
  "avatar_color": null,
  "banner": null,
  "banner_color": null,
  "bio": null,
  "nameplate": null,
  "bot": true,
  "flags": 0,
  "premium_type": 0
}

Поле	Тип	Описание
`id`	snowflake	Уникальный ID
`username`	string	Никнейм (`[A-Za-z0-9_]{2,32}` для ботов)
`global_name`	string \| null	Отображаемое имя (с пробелами и юникодом)
`avatar`	string \| null	Hash аватара. URL: `https://floodilka.com/avatars/<user_id>/<avatar>.png`
`avatar_color`	string \| null	Hex-цвет заглушки, если аватара нет
`banner`	string \| null	Hash баннера профиля
`banner_color`	string \| null	Hex-цвет заглушки баннера
`bio`	string \| null	О себе, до 190 символов
`nameplate`	object \| null	Премиум-украшение плашки имени
`bot`	boolean	`true` для бот-пользователей
`flags`	integer	Битовое поле публичных флагов (`STAFF`, `EARLY_SUPPORTER`, `VERIFIED_BOT` и т.п.)
`premium_type`	integer	Премиум-статус: `0` — нет, `1` — Classic, `2` — Full, `3` — Guild-Premium

Эндпоинты

GET /users/@me

Возвращает бота самого.

curl https://floodilka.com/api/v1/users/@me \
  -H "Authorization: Bot ВАШ_БОТ_ТОКЕН"

Используйте для проверки валидности токена при старте бота.

GET /users/:user_id

Возвращает публичный профиль любого пользователя по ID. Видны только публичные поля (те что в таблице выше).

curl https://floodilka.com/api/v1/users/974839103102976000 \
  -H "Authorization: Bot ВАШ_БОТ_ТОКЕН"

GET /users/@me/guilds

Список гильдий, в которых состоит бот. Поддерживает пагинацию через before, after, limit (до 200).

curl "https://floodilka.com/api/v1/users/@me/guilds?limit=100" \
  -H "Authorization: Bot ВАШ_БОТ_ТОКЕН"

PATCH /users/@me

Меняет публичный профиль бота — имя, аватар, баннер, bio. Изображения передаются как data-URL:

curl -X PATCH https://floodilka.com/api/v1/users/@me \
  -H "Authorization: Bot ВАШ_БОТ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "my_cool_bot",
    "avatar": "data:image/png;base64,iVBORw0KGgo..."
  }'

После смены профиля все клиенты в гильдиях увидят обновлённое имя и аватар в течение секунд.

Что дальше

Гильдии — объект участника гильдии (Member), который оборачивает User
Приложения и OAuth2 — как сбрасывать токен и управлять приложением