Developers Ник, Premium, галочки

Ник, Premium, галочки

Как корректно показывать имя пользователя, подписку Premium и значки верификации в вашем интерфейсе.

Отображаемый ник

Используйте в таком порядке:

  1. display_name, если не пустой
  2. иначе username (без @ в UI, если не нужен handle)

В userinfo поле name уже содержит итоговое значение.

Premium

Активная подписка определяется на стороне MiuOne ID. В API поиска:

{ "username": "arnur", "premium": true, … }

Стиль ника Premium

На id.miuone.kz Premium-ник подсвечивается классом .prem-name-blue:

.prem-name-blue {
  color: #38bdf8;
  font-weight: 600;
}

Рядом с ником — иконка короны (SVG из каталога ассетов). Не меняйте смысл: синий ник + корона = активный Premium.

Для OAuth-сессии текущего пользователя: GET /api/v1/premium/statusactive, expires_at, billing_period.

Верификация (галочки)

Уровеньverification_tierОтображение
0noneБез значка
1standardСтандартная галочка (синяя)
2specialОсобая галочка (золотая / partner)

URL значков

Официальные SVG на id.miuone.kz (не копируйте — подгружайте по URL):

TierURL
standardhttps://id.miuone.kz/assets/verification/verified_badge.svg?v=1
special (тёмная тема)…/verified_badge_special.svg?v=1
special (светлая тема)…/verified_badge_special_light.svg?v=1

Полный каталог ассетов — файл AssetsCatalog.txt в репозитории интеграций.

Пример разметки

<span class="user-name prem-name-blue">Arnur</span>
<img src="https://id.miuone.kz/assets/verification/verified_badge.svg?v=1"
     width="16" height="16" alt="Verified" loading="lazy">

Для special на сайте показываются обе версии (light/dark), видимость переключается CSS по data-theme.

Платформенные теги

Поле tag в userinfo — объект с label (например «ПАРТНЁР»), kind и slug. Показывайте текстовую метку или стилизуйте по kind.

Аватар

picture / avatar_url — полный HTTPS URL или пустая строка. Fallback: инициалы или placeholder вашего дизайна.

Списки и поиск

Для списков и поиска используйте GET /api/users/search?q=… — в ответе уже есть premium, verification_tier, avatar_url.