Developers Профиль и userinfo

Профиль и 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, idID пользователя (строка / число)
name, nicknameОтображаемый ник (display_name или username)
preferred_username, username@идентификатор
display_nameИмя, заданное пользователем
picture, avatar_urlАбсолютный URL аватара или пусто
emailТолько при scope и если разрешено
email_verifiedПодтверждён ли email входа
verified, verification_level0 — нет, 1 — обычная, 2 — special
verification_tiernone | standard | special
verified_badgetrue, если 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).