Для разработчиков

Информация о токене

GET/oauth/token/info

Сведения о токене, которым сделан сам запрос: его скоупы, владелец, даты создания и последнего использования. Сам токен приходит замаскированным — видны только первые 8 и последние 4 символа.

Метод не требует скоупа и отвечает на любой действующий токен, личный или бота. Поэтому им удобно проверять токен перед работой: живой отвечает 200, отозванный или просроченный — 401, а список скоупов сразу показывает, какие методы этому токену доступны.

Чей это токен, видно по user_id. Полную карточку владельца отдаёт GETСвой профиль.

Ответ

200OK
The request has succeeded.
data
object
*
Токен доступа
id
integer, (int64)
*
Идентификатор токена
Пример:4827
token
string
*
Маскированный токен (видны первые 8 и последние 4 символа)
Пример:cH5kR9mN...x7Qp
name
nullablestring
*
Имя токена. У входа из CLI это имя устройства, у токена внешнего приложения — имя приложения. null, если имени нет, например у токена, который сотрудник выдал боту на экране согласия.
Пример:Мой API токен
user_id
integer, (int64)
*
Идентификатор владельца токена
Пример:12
scopes[]
array of strings
*
Список скоупов токена
Возможные значения
Пример:["messages:read","chats:read"]
created_at
string, (date-time)
*
Дата создания токена
Пример:2025-01-15T10:30:00.000Z
revoked_at
nullablestring, (date-time)
*
Дата отзыва токена. Всегда null: по отозванному токену метод возвращает 401.
Пример:null
expires_in
nullableinteger, (int32)
*
Время жизни токена в секундах. У входа из CLI и у токена внешнего приложения, которому сотрудник выдал доступ, здесь 3600: токен живёт час и продлевается токеном обновления, CLI делает это сам. У остальных токенов null: они бессрочные.
Пример:null
last_used_at
nullablestring, (date-time)
*
Дата последнего использования токена. null, пока по токену не было ни одного запроса. Обновляется не чаще раза в минуту, поэтому может отставать.
Пример:2025-02-24T14:20:00.000Z
authorized_at
nullablestring, (date-time)
*
Дата входа из CLI или выдачи доступа внешнему приложению. При продлении токена не меняется. У остальных токенов null.
Пример:null
Информация о токене
pachca oauth token-info \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": {    "id": 4827,    "token": "cH5kR9mN...x7Qp",    "name": "Мой API токен",    "user_id": 12,    "scopes": [      "messages:read",      "chats:read"    ],    "created_at": "2025-01-15T10:30:00.000Z",    "revoked_at": null,    "expires_in": null,    "last_used_at": "2025-02-24T14:20:00.000Z",    "authorized_at": null  }}