Получение информации о видео, прикреплённом к сообщению

Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен platform-api2.max.ru вместо platform-api.max.ru. Также убедитесь, что добавили сертификат Минцифры в список доверенных

GET/videos/{videoToken}

Возвращает подробную информацию о видео, прикреплённом к сообщению в чате или канале, URL-адреса воспроизведения и дополнительные метаданные

Пример запроса:

BASH

Скопировать

curl -X GET "https://platform-api2.max.ru/videos/{video_token}" \
  -H "Authorization: {access_token}"

Авторизация

access_token
apiKey

Передача токена через query-параметры больше не поддерживается — используйте заголовок Authorization: <token>

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить
Eсли вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Токен может быть отозван за нарушение Правил платформы

Параметры

videoToken
string
[a-zA-Z0-9_\-]+

Токен видео-вложения

Результат

token
string

Токен видео-вложения

urls
object VideoUrls Nullable optional

URL-ы для скачивания или воспроизведения видео. Может быть null, если видео недоступно

thumbnail
object PhotoAttachmentPayload Nullable optional

Миниатюра видео

width
integer

Ширина видео

height
integer

Высота видео

duration
integer

Длина видео в секундах

Коды ответов

Код	Описание
`200`	Подробная информация о прикреплённом видео
`401`	Ошибка авторизации. Токен `access_token` указан некорректно или недействителен
`403`	Ошибка доступа. У вас нет прав на доступ к этому ресурсу
`404`	В случае, если сообщение не найдено или бот не имеет доступа к нему
`500`	Внутренняя ошибка сервера