FILIPP·TECH CDN API

Интерактивный справочник платформы доставки видео · HLS / DASH / Progressive

Работаем в штатном режиме обновлено 2 мин назад

Base URL https://content.filipp-tech.info

Введение

FILIPP·TECH CDN · платформа доставки видео: приём исходников, транскодирование в адаптивные форматы и раздача через ближайший к зрителю edge-сервер.

Приём. Resumable-загрузка по TUS до 10 ГБ, проверка целостности по SHA-256.
Обработка. Лестница 240p-1080p, HLS и DASH, сегменты по 6 секунд.
Раздача. Signed-ссылки с TTL и привязкой к IP, кэширование на edge.

Все запросы выполняются по HTTPS к базовому URL выше. Формат ответов JSON.

Аутентификация

Все запросы требуют заголовок с ключом:

X-Api-Key: ft_live_9f2c••••••••••••••••••••1a5f

Ключ выдаётся в личном кабинете и привязан к проекту. Не передавайте его в браузерный код.

GET/api/v2/videosСписок видео

Возвращает список видео аккаунта с пагинацией и статусом обработки.

curl -H "X-Api-Key: $KEY" "https://content.filipp-tech.info/api/v2/videos?page=1&per_page=20"

Response · 200 · application/json

{
  "data": [
    { "id": "ab12cd34", "title": "master_final_v3.mp4", "status": "ready",
      "duration_sec": 754, "size_bytes": 184211923,
      "renditions": ["1080p", "720p", "480p", "240p"],
      "created_at": "2026-08-30T14:12:08Z" },
    { "id": "f9e8d7c6", "title": "promo_autumn.mp4", "status": "processing",
      "duration_sec": 96, "size_bytes": 22103441,
      "renditions": ["720p"], "created_at": "2026-09-03T09:41:55Z" }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 2 }
}

GET/api/v2/video/manifestМанифест HLS/DASH

Возвращает манифест воспроизведения с вариантами качества и подписанными URL.

Параметр	Тип	Описание
id	string	Идентификатор видео
format	string	hls \| dash

curl -H "X-Api-Key: $KEY" "https://content.filipp-tech.info/api/v2/video/manifest?id=ab12cd34&format=hls"

Response · 200 · application/json

{
  "id": "ab12cd34", "format": "hls",
  "master_url": "https://cdn.filipp-tech.info/video/download/ab12cd34/hls/master.m3u8?sig=9f2c&ttl=1767211200",
  "variants": [
    { "rendition": "1080p", "bandwidth_bps": 5800000, "codecs": "avc1.640028,mp4a.40.2" },
    { "rendition": "720p",  "bandwidth_bps": 3200000, "codecs": "avc1.4d401f,mp4a.40.2" },
    { "rendition": "480p",  "bandwidth_bps": 1400000, "codecs": "avc1.4d401e,mp4a.40.2" },
    { "rendition": "240p",  "bandwidth_bps": 500000,  "codecs": "avc1.42c015,mp4a.40.2" }
  ],
  "ttl_sec": 7200
}

POST/api/v2/uploadСессия загрузки (TUS)

Создаёт resumable-сессию загрузки исходника и возвращает TUS-endpoint для чанков.

curl -X POST -H "X-Api-Key: $KEY" -F "file=@master.mp4" \
  https://content.filipp-tech.info/api/v2/upload

Response · 201 · application/json

{
  "upload_id": "up_5f2a91c4",
  "tus_url": "https://content.filipp-tech.info/api/v2/upload/up_5f2a91c4",
  "max_bytes": 10737418240, "chunk_bytes": 8388608,
  "expires_at": "2026-09-05T12:00:00Z", "checksum_algo": "sha256"
}

GET/api/v2/videos/{id}/renditionsЛестница качеств

Возвращает транскодированные варианты видео с параметрами кодирования.

curl -H "X-Api-Key: $KEY" "https://content.filipp-tech.info/api/v2/videos/ab12cd34/renditions"

Response · 200 · application/json

{
  "video_id": "ab12cd34", "segment_duration_sec": 6,
  "renditions": [
    { "name": "1080p", "height": 1080, "bitrate_bps": 5800000, "fps": 30, "codec": "h264", "segments": 126 },
    { "name": "720p",  "height": 720,  "bitrate_bps": 3200000, "fps": 30, "codec": "h264", "segments": 126 },
    { "name": "480p",  "height": 480,  "bitrate_bps": 1400000, "fps": 30, "codec": "h264", "segments": 126 },
    { "name": "240p",  "height": 240,  "bitrate_bps": 500000,  "fps": 30, "codec": "h264", "segments": 126 }
  ]
}

GET/api/v2/statsСтатистика доставки

Метрики доставки за период: запросы, трафик, hit-ratio, задержка, регионы.

curl -H "X-Api-Key: $KEY" "https://content.filipp-tech.info/api/v2/stats?video_id=ab12cd34&period=24h"

Response · 200 · application/json

{
  "video_id": "ab12cd34", "period": "24h",
  "requests": 18412, "bytes_served": 92310044160,
  "cache_hit_ratio": 0.94, "avg_latency_ms": 24,
  "top_regions": [
    { "region": "RU-MOW", "requests": 12031 },
    { "region": "RU-SPE", "requests": 3877 },
    { "region": "NL-NH",  "requests": 2504 }
  ]
}

GET/api/v2/edge/nodesEdge-серверы

Состояние точек присутствия: задержка, загрузка, статус.

curl -H "X-Api-Key: $KEY" "https://content.filipp-tech.info/api/v2/edge/nodes"

Response · 200 · application/json

{
  "nodes": [
    { "code": "MOW-1", "city": "Москва",          "rtt_ms": 4,  "load": 0.42, "status": "online" },
    { "code": "SPE-1", "city": "Санкт-Петербург", "rtt_ms": 8,  "load": 0.31, "status": "online" },
    { "code": "AMS-2", "city": "Амстердам",       "rtt_ms": 38, "load": 0.57, "status": "online" },
    { "code": "FRA-1", "city": "Франкфурт",       "rtt_ms": 41, "load": 0.49, "status": "online" }
  ]
}

POST/api/v2/links/signПодписанная ссылка

Генерирует signed-ссылку с TTL и опциональной привязкой к IP зрителя.

curl -X POST -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"video_id":"ab12cd34","ttl_sec":7200,"ip_lock":true}' \
  https://content.filipp-tech.info/api/v2/links/sign

Response · 200 · application/json

{
  "video_id": "ab12cd34",
  "url": "https://cdn.filipp-tech.info/video/download/ab12cd34?sig=a1b2c3d4&ttl=1767211200&ip=85.140.0.0/16",
  "sig": "a1b2c3d4", "expires_at": "2026-09-05T14:00:00Z", "ip_lock": true
}

Коды ошибок

Код	code	Описание
400	bad_request	Неверные параметры запроса или тело
401	unauthorized	Ключ отсутствует или недействителен
403	forbidden	Нарушена привязка к IP или права проекта
404	not_found	Объект не существует или удалён
429	rate_limited	Превышен лимит запросов, см. заголовки X-RateLimit
500	internal	Внутренняя ошибка, повторите запрос позже

{ "error": { "code": "rate_limited", "message": "Слишком много запросов, повторите через 12 секунд", "request_id": "req_7c21f9aa" } }

Лимиты

60 запросов в минуту на ключ, burst до 120.
Загрузка: файл до 10 ГБ, чанк 8 МБ, не более 5 параллельных сессий.
Signed-ссылки: TTL до 24 часов.

Каждый ответ содержит заголовки:

X-RateLimit-Limit: 60 X-RateLimit-Remaining: 57 X-RateLimit-Reset: 1767211260

Changelog

v2.4.12026-08-28

DASH с CMAF-сегментами, расширенная диагностика edge, поле load в /edge/nodes.

v2.4.02026-07-15

Signed-ссылки v2: TTL до 24 часов, привязка к IP, параметр ip_lock.

v2.3.22026-06-02

Resumable-загрузки по TUS 1.0, проверка целостности по SHA-256.

v2.3.02026-05-02

Публичная статистика доставки и мониторинг edge-серверов.