Получить информацию о видео

⚠️ До 19 июля 2026

Для корректной работы ваших чат-ботов и мини-приложений необходимо перенаправить HTTP-запросы с домена platform-api.max.ru на platform-api2.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-запросов присваивается при создании бота — его можно найти на платформе в разделе Чат-боты → Перейти → Расширенные настройки → Настроить

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

Параметры

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

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