Документация API Reference Console v3.2.1

API видеохостинга VidFlow

Загружайте, управляйте и стримите видео через мощный REST API.

Все системы работают стабильно
99.9%
Uptime
4.2M
Запросов / день
180+
Стран
17ms
Средняя задержка

Основные операции с видео

GET
/api/v1/videos
Получить список всех видео с пагинацией
public
POST
/api/v1/videos
Загрузить новое видео (multipart/form-data)
auth
GET
/api/v1/videos/:id
Получить информацию о видео по ID
public
PUT
/api/v1/videos/:id
Обновить метаданные видео
auth
DELETE
/api/v1/videos/:id
Удалить видео
auth
📦 Ответ сервера (GET /api/v1/videos/:id)
{
  "id": "vid_abc123",
  "title": "Демонстрация нового API",
  "duration": 187,
  "views": 12450,
  "likes": 342,
  "status": "processed",
  "uploaded_at": "2026-08-08T12:34:56Z",
  "urls": {
    "hls": "https://cdn.serversokolok.online/videos/vid_abc123/playlist.m3u8",
    "thumbnail": "https://cdn.serversokolok.online/videos/vid_abc123/thumb.jpg"
  },
  "is_public": true
}

Управление плейлистами

GET
/api/v1/playlists
Список всех плейлистов пользователя
auth
POST
/api/v1/playlists
Создать новый плейлист
auth
POST
/api/v1/playlists/:id/videos
Добавить видео в плейлист
auth
DELETE
/api/v1/playlists/:id/videos/:video_id
Удалить видео из плейлиста
auth
📦 Ответ сервера (GET /api/v1/playlists)
{
  "playlists": [
    {
      "id": "pl_001",
      "name": "Мои лучшие видео",
      "video_count": 12,
      "created_at": "2026-07-15T10:00:00Z"
    },
    {
      "id": "pl_002",
      "name": "Туториалы",
      "video_count": 8,
      "created_at": "2026-07-20T14:30:00Z"
    }
  ],
  "total": 2
}

Аналитика и статистика

GET
/api/v1/analytics/video/:id
Полная аналитика по видео (просмотры, лайки, география)
auth
GET
/api/v1/analytics/dashboard
Сводная статистика по всем видео пользователя
auth
GET
/api/v1/analytics/realtime
Текущие просмотры в реальном времени
auth
📊 Ответ сервера (GET /api/v1/analytics/video/:id)
{
  "video_id": "vid_abc123",
  "total_views": 12450,
  "likes": 342,
  "dislikes": 18,
  "avg_watch_time": 92.5,
  "geography": {
    "US": 4200,
    "DE": 1800,
    "GB": 1200,
    "RU": 950
  },
  "devices": {
    "mobile": 0.62,
    "desktop": 0.31,
    "tablet": 0.07
  }
}

Авторизация и управление доступом

POST
/api/v1/auth/login
Вход в аккаунт (email + пароль)
public
POST
/api/v1/auth/refresh
Обновить JWT-токен
auth
POST
/api/v1/auth/logout
Завершить сессию
auth
POST
/api/v1/auth/register
Регистрация нового пользователя
public
🔐 Ответ сервера (POST /api/v1/auth/login)
{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4=",
  "user": {
    "id": "user_001",
    "email": "user@example.com",
    "name": "Алексей",
    "plan": "pro"
  },
  "expires_in": 3600
}