Выпускает боту ещё один токен со своим именем и правами. Токенов у бота может быть несколько: например, отдельный на каждый сервис, чтобы отзывать их по одному.
Значение токена приходит в ответе один раз — сохраните его сразу. Токен бессрочный и работает, пока его не удалят.
Права выбирают из тех, что можно выдать боту: их перечисляет GETКаталог прав бота. На право не из каталога метод отвечает 400. Без scopes токен выпускается без прав.
Работать с токенами бота могут только его создатель и администратор пространства, если настройки бота открывают администраторам доступ к редактированию. Владельцу чата с ботом метод отвечает 403, даже когда остальные настройки бота ему открыты.
Параметры пути
id
integer, (int32)
*Идентификатор бота
Пример:
1738816Тело запроса
application/jsonname
string
*Имя токена: по нему токены различают в списке
Пример:
Сервер уведомленийДлина:
<= 255 символовscopes[]
array of strings
Права токена. Доступны только права, которые можно выдать боту. Если не передать, токен выпускается без прав.
Пример:
["messages:create","chats:read"]Ответ
201Created
The request has succeeded and a new resource has been created as a result.
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