VideoHost API — Reference

Query param	Description
`limit`integer	Максимум записей на странице. По умолчанию 20.
`cursor`string	Курсор пагинации из предыдущего ответа.
`sort`string	Сортировка: `uploaded_at` или `views`.

curl -X GET https://api.videohost.dev/v1/videos \
-H "Authorization: Bearer vh_live_••••••"

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

{
  "status": "success",
  "data": [
    {
      "id": "vid_001",
      "title": "Котёнок играет с мячом",
      "duration": 42,
      "views": 1520,
      "uploaded_at": "2026-07-28T14:23:00Z",
      "author": "user_alpha"
    },
    {
      "id": "vid_002",
      "title": "Обзор новой камеры 4K",
      "duration": 187,
      "views": 843
    }
  ],
  "total": 2, "next_cursor": null
}

Параметры запроса отображены в таблице выше. Этот mock endpoint не требует реальной авторизации.

Path param	Description
`id`stringREQUIRED	Уникальный идентификатор: например, `vid_001`.

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

{
  "status": "success",
  "data": {
    "id": "vid_002",
    "title": "Обзор новой камеры 4K",
    "resolution": "3840x2160",
    "duration": 187,
    "views": 843
  }
}

Body field	Description
`title`stringREQUIRED	Название видео.
`source_url`stringREQUIRED	Ссылка на исходный файл для обработки.
`tags`array	Теги для категоризации.

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

{
  "status": "success",
  "data": {
    "id": "vid_004",
    "processing_status": "queued"
  }
}

Path param	Description
`id`stringREQUIRED	Идентификатор удаляемого видео.

404 Not FoundПример ошибки

{
  "status": "error",
  "message": "Video with given id was not found",
  "code": 404
}

VideoHost API · Mock server for prototyping and integration testing · v1.0

API Reference