Заменяет значение токена новым: прежнее сразу перестаёт работать, имя и права остаются. Новое значение приходит в ответе один раз — сохраните его сразу.
Метод нужен, когда токен утёк или его меняют по плану. Основной токен бота перевыпускает и POSTРотация токена бота.
Работать с токенами бота могут только его создатель и администратор пространства, если настройки бота открывают администраторам доступ к редактированию. Владельцу чата с ботом метод отвечает 403, даже когда остальные настройки бота ему открыты.
Параметры пути
id
integer, (int32)
*Идентификатор бота
Пример:
1738816token_id
integer, (int64)
*Идентификатор токена
Пример:
4827Ответ
200OK
The request has succeeded.
data
object
*Токен бота
id
integer, (int64)
*Идентификатор токена
Пример:
4827token
string
*Токен в маскированном виде (видны первые 8 и последние 4 символа). Полное значение приходит один раз: при выпуске и перевыпуске токена.
Пример:
cH5kR9mN...x7Qpname
nullablestring
*Имя токена.
null у токена, выпущенного без имени.Пример:
Сервер уведомленийuser_id
integer, (int64)
*Идентификатор бота, которому принадлежит токен
Пример:
1738816scopes[]
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.000Zrevoked_at
nullablestring, (date-time)
*Дата отзыва токена. Всегда
null: отозванные токены в ответ не попадают.Пример:
nullexpires_in
nullableinteger, (int32)
*Время жизни токена в секундах. У токенов бота
null: они бессрочные.Пример:
nulllast_used_at
nullablestring, (date-time)
*Дата последнего использования токена.
null, пока по токену не было ни одного запроса. Обновляется не чаще раза в час, поэтому может отставать.Пример:
2025-02-24T14:20:00.000Zauthorized_at
nullablestring, (date-time)
*Дата авторизации. У токенов бота
null.Пример:
null