OAuth2 — API — Voice для разработчиков

Методы Voice ID. Пошаговое руководство — Войти через Voice.

GET/oauth2/authorize

Экран входа (страница, не API)

без токена

Открывается в браузере пользователя на https://voice-chat.ru. Параметры: client_id, redirect_uri, response_type=code, scope, state, code_challenge, code_challenge_method=S256, nonce; для ботов — permissions.

POST/api/oauth2/token

Получить или обновить токен

без токена

Параметр	Тип	Описание
`grant_type`обяз.	string	authorization_code или refresh_token.
`client_id`обяз.	string	ID приложения (или в Basic-заголовке).
`client_secret`	string	Секрет (или в Basic-заголовке). Не нужен, если код получен с PKCE.
`code`	string	Для authorization_code.
`redirect_uri`	string	Должен совпадать с тем, что был при авторизации.
`code_verifier`	string	PKCE.
`refresh_token`	string	Для refresh_token.

Ошибки: invalid_client (401), invalid_grant (400), unsupported_grant_type (400), slow_down (429) — в виде { "error", "error_description" }. Не больше 60 запросов в минуту с адреса.

POST/api/oauth2/token/revoke

Отозвать токен

без токена

Тело: token — токен доступа или обновления. Отзывает всю пару. Ответ всегда {}.

GET/api/oauth2/userinfo

Данные пользователя (OIDC userinfo)

Bearer · identify

JSON

{
  "sub": "u_…", "id": "u_…",
  "username": "alice", "preferred_username": "alice",
  "name": "Алиса", "display_name": "Алиса",
  "avatar": "https://voice-chat.ru/uploads/avatars/….webp", "picture": "https://voice-chat.ru/uploads/avatars/….webp",
  "created_at": 1767225600000,
  "email": "alice@example.com", "email_verified": true     // со scope email
}

Синоним: GET /api/oauth2/@me.

GET/api/oauth2/keys

Ключи для проверки id_token (JWKS)

без токена

GET/.well-known/openid-configuration

OpenID Connect discovery

без токена