Профиль и userinfo
Поля профиля после успешной авторизации. Токен передаётся в заголовке Authorization: Bearer.
Userinfo
GET /api/v1/oauth/userinfo
Authorization: Bearer mio_at_…
Альтернатива — /me
GET /api/v1/me
Объединяет ok: true, полный oauth_user_payload и поля userinfo.
Основные поля
| Поле | Описание |
|---|---|
sub, id | ID пользователя (строка / число) |
name, nickname | Отображаемый ник (display_name или username) |
preferred_username, username | @идентификатор |
display_name | Имя, заданное пользователем |
picture, avatar_url | Абсолютный URL аватара или пусто |
email | Только при scope и если разрешено |
email_verified | Подтверждён ли email входа |
verified, verification_level | 0 — нет, 1 — обычная, 2 — special |
verification_tier | none | standard | special |
verified_badge | true, если level ≥ 1 |
minecraft, minecraft_name | Привязка MC, если есть |
tag | Объект { label, kind, slug } или отсутствует |
Пример ответа
{
"sub": "42",
"name": "Arnur",
"preferred_username": "arnur",
"picture": "https://id.miuone.kz/avatars/…",
"verification_level": 1,
"verification_tier": "standard",
"verified_badge": true,
"minecraft_linked": true,
"minecraft_name": "Steve"
}
Ошибки
401 unauthorized— нет Bearer или неверный формат401 invalid_token— токен отозван или истёк
Premium в userinfo
Статус Premium в userinfo напрямую не передаётся. Для текущего пользователя используйте GET /api/v1/premium/status, для списков — поиск пользователей (поле premium).