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

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

GET/videos/{videoToken}

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

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

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

Авторизация

access_token

apiKey

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты. Выберите необходимого бота и нажмите ⋮ → Настройки → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в мини-приложении «MAX для бизнеса», получить токен можно там же или в боте «MAX для бизнеса» с помощью команды Получить токен

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

Параметры

videoToken

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

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

Результат

token

string

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

urls

object VideoUrls Nullableoptional

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

mp4_1080

string Nullableoptional

URL видео в разрешении 1080p, если доступно

mp4_720

string Nullableoptional

URL видео в разрешении 720p, если доступно

mp4_480

string Nullableoptional

URL видео в разрешении 480p, если доступно

mp4_360

string Nullableoptional

URL видео в разрешении 360p, если доступно

mp4_240

string Nullableoptional

URL видео в разрешении 240p, если доступно

mp4_144

string Nullableoptional

URL видео в разрешении 144p, если доступно

hls

string Nullableoptional

URL трансляции, если доступна

thumbnail

object PhotoAttachmentPayload Nullableoptional

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

photo_id

integer <int64>

Уникальный ID этого изображения

token

string

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов POST /uploads

url

string

URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре expires — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

width

integer

Ширина видео

height

integer

Высота видео

duration

integer

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

Коды ответов

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