

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

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

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

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

## Авторизация

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

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

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

## Параметры

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

## Результат

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

URL видео в разрешении 1080p, если доступно
URL видео в разрешении 720p, если доступно
URL видео в разрешении 480p, если доступно
URL видео в разрешении 360p, если доступно
URL видео в разрешении 240p, если доступно
URL видео в разрешении 144p, если доступно
URL трансляции, если доступна

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

Уникальный ID этого изображения
Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)
URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре `expires` — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

Ширина видео
Высота видео
Длина видео в секундах

## Коды ответов

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

