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

Список токенов бота

GET/bots/{id}/tokens
bots:read

Действующие токены бота: основной, выпущенный вместе с ботом, и отдельные — со своим именем и правами. Значение токена здесь замаскировано: полностью его показывают один раз, при выпуске и перевыпуске.

Работать с токенами бота могут только его создатель и администратор пространства, если настройки бота открывают администраторам доступ к редактированию. Владельцу чата с ботом метод отвечает 403, даже когда остальные настройки бота ему открыты.

Параметры пути

id
integer, (int32)
*
Идентификатор бота
Пример:1738816

Параметры строки запроса

limit
integer, (int32)
Количество возвращаемых сущностей за один запрос
Пример:1
По умолчанию:
50
Диапазон:
1 — 50
cursor
string
Курсор для пагинации (из meta.paginate.next_page)
Пример:eyJpZCI6NDgyN30

Ответ

200OK
The request has succeeded.
data[]
array of objects
*
id
integer, (int64)
*
Идентификатор токена
Пример:4827
token
string
*
Токен в маскированном виде (видны первые 8 и последние 4 символа). Полное значение приходит один раз: при выпуске и перевыпуске токена.
Пример:cH5kR9mN...x7Qp
name
nullablestring
*
Имя токена. null у токена, выпущенного без имени.
Пример:Сервер уведомлений
user_id
integer, (int64)
*
Идентификатор бота, которому принадлежит токен
Пример:1738816
scopes[]
array of strings
*
Права токена
Пример:["messages:create","chats:read"]
created_at
string, (date-time)
*
Дата и время выпуска токена (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2025-01-15T10:30:00.000Z
revoked_at
nullablestring, (date-time)
*
Дата отзыва токена. Всегда null: отозванные токены в ответ не попадают.
Пример:null
expires_in
nullableinteger, (int32)
*
Время жизни токена в секундах. У токенов бота null: они бессрочные.
Пример:null
last_used_at
nullablestring, (date-time)
*
Дата последнего использования токена. null, пока по токену не было ни одного запроса. Обновляется не чаще раза в час, поэтому может отставать.
Пример:2025-02-24T14:20:00.000Z
authorized_at
nullablestring, (date-time)
*
Дата авторизации. У токенов бота null.
Пример:null
meta
object
*
Метаданные пагинации
paginate
object
*
Вспомогательная информация
next_page
string
*
Курсор пагинации следующей страницы
Пример:eyJxZCO2MiwiZGlyIjomSNYjIn3
prev_page
string
Курсор пагинации предыдущей страницы. Используется для polling новых записей «сверху» списка.
Пример:eyJxZCO2MiwiZGlyIjoiYXNjIn0
has_next
boolean
Есть ли ещё данные на следующей странице. На последней странице — false.
Пример:true
has_prev
boolean
Есть ли ещё данные на предыдущей странице. На первом запросе без курсора — false.
Пример:false
Список токенов бота
# Добавьте --all для автоматической пагинацииpachca bots list-tokens 1738816 \  --limit=1 \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": [    {      "id": 4827,      "token": "cH5kR9mN...x7Qp",      "name": "Сервер уведомлений",      "user_id": 1738816,      "scopes": [        "messages:create",        "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    }  ],  "meta": {    "paginate": {      "next_page": "eyJpZCI6NDgyN30"    }  }}