Справочник API

Эндпоинты версии v1. Префикс: https://id.miuone.kz/api/v1/

Каталог

GET /api/v1/index.php или /api/v1/

Список доступных маршрутов и краткое описание.

OAuth

GET /oauth/authorize

Старт Authorization Code. Параметры: client_id, redirect_uri, response_type=code, state, scope.

POST /oauth/token

Обмен code на access_token. Basic Auth, grant_type=authorization_code.

GET /oauth/userinfo

Профиль по Bearer-токену. См. поля.

Профиль

GET /me

Текущий пользователь по OAuth-токену. JSON: ok, user, oauth-поля.

Поиск пользователей

GET /api/users/search?q={query}

Публичный поиск (не v1). Параметр username=1 — только по @username. Ответ:

{
  "ok": true,
  "query": "arn",
  "results": [{
    "id": 42,
    "username": "arnur",
    "display_name": "Arnur",
    "avatar_url": "https://…",
    "premium": false,
    "verification_tier": "standard",
    "verified": true,
    "url": "/arnur"
  }]
}

Premium

GET /premium/status

Только для Bearer владельца аккаунта.

{
  "ok": true,
  "active": true,
  "expires_at": "2026-07-01 00:00:00",
  "billing_period": "monthly",
  "days_left": 30,
  "wallet_balance": 1500.0
}

Кошелёк

Списание через API доступно только одобренным OAuth-клиентам с правом wallet. Обычным сайтам достаточно userinfo и поиска.

GET /wallet/balance

Баланс MiuCoins текущего пользователя по Bearer-токену.

POST /wallet/charge

Списание с кошелька (JSON: amount, currency, description, idempotency_key…).

GET /wallet/transactions

История операций кошелька.

Ассеты и значки

Отдельного JSON-каталога нет — используйте стабильные URL из раздела Ник, Premium, галочки и файл AssetsCatalog.txt.

Статус платформы

GET /platform/status

Общий статус сервисов (maintenance, incidents). Публичный.

Mobile Auth

/api/v1/mobile/* — только официальное приложение MiuOne ID (подпись, device_id). Сторонним клиентам недоступно.

Методы: challenge, verify, refresh, logout — см. внутреннюю спецификацию для мобильной команды.

Коды ошибок

HTTP	error	Когда
400	`invalid_request`	Неверные параметры OAuth
401	`invalid_client`	Неверный client_id / secret
401	`invalid_token`	Токен недействителен
403	`access_denied`	Нет прав на эндпоинт
429	`rate_limited`	Слишком много запросов