Video API · Swagger-style

GET /videos список

Получить список всех доступных видео (заглушка).

Параметры запроса

limit integer 10 Максимальное количество видео (необязательно)

offset integer 0 Смещение для пагинации (необязательно)

Ответ (200 OK)

Пример ответа

{
  "data": [
    { "id": "vid-1", "title": "Закат над океаном", "duration": 120, "format": "mp4" },
    { "id": "vid-2", "title": "Городской трафик", "duration": 85, "format": "mov" },
    { "id": "vid-3", "title": "Туториал по React", "duration": 340, "format": "mp4" }
  ],
  "pagination": { "total": 12, "limit": 10, "offset": 0 }
}
            

GET /videos/{id} информация

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

Параметры

id string (path) vid-1 Уникальный идентификатор видео

Ответ (200 OK)

Пример ответа

{
  "id": "vid-1",
  "title": "Закат над океаном",
  "description": "Красивый закат, снятый на побережье.",
  "duration": 120,
  "format": "mp4",
  "size": 24500000,
  "url": "https://storage.example/videos/vid-1.mp4"
}
            

POST /videos/download скачивание

Запросить ссылку для скачивания видео. (заглушка)

Тело запроса (JSON)

videoId string "vid-1" ID видео для скачивания

quality string "1080p" Желаемое качество (необязательно)

Ответ (200 OK)

Пример ответа

{
  "downloadUrl": "https://storage.example/download/vid-1?token=abc123",
  "expiresIn": 3600,
  "quality": "1080p"
}
            

POST /videos загрузка

Загрузить новое видео (мок‑заглушка).

Тело запроса (multipart/form-data)

file binary video.mp4 Видеофайл для загрузки

title string "Мой ролик" Название видео

Ответ (201 Created)

Пример ответа

{
  "id": "vid-99",
  "title": "Мой ролик",
  "status": "uploaded",
  "message": "Видео успешно загружено (заглушка)"
}
            

VideoAPI · swagger‑style