Reactive Delivery

Документация

Подключение, структура путей, кеширование и API.

Быстрый старт

Создайте ресурс, укажите источник и пропишите CNAME. Проверить, что трафик пошёл через узел, можно по заголовкам ответа:

$ curl -I https://media.example.com/assets/app.js

HTTP/2 200
server: rdl-edge
x-rdl-cache: HIT
x-rdl-node: ru-msk-02
cache-control: public, max-age=31536000, immutable

Структура путей HLS

Плеер сначала запрашивает плейлист, затем последовательно тянет сегменты. Имя сегмента формирует ваш упаковщик, узел его не меняет. Типичная раскладка для живой трансляции:

# мастер-плейлист
/live/{stream}/index.m3u8

# плейлист качества
/live/{stream}/{profile}/playlist.m3u8

# транспортные сегменты
/live/{stream}/{profile}/segment0.ts
/live/{stream}/{profile}/segment1.ts
/live/{stream}/{profile}/segment2.ts

Сегменты живой трансляции отдаются сквозным потоком и не кешируются: каждый из них запрашивается один раз и тут же устаревает. Для VOD действует обратное правило — сегменты кешируются на 30 суток.

Если ваш упаковщик держит длинные соединения на сегмент (low-latency HLS, chunked transfer), включите в настройках ресурса режим streaming. Он отключает буферизацию и снимает ограничение на время ответа.

Правила кеширования

Тип контентаTTL по умолчаниюКлюч кеша
.m3u8, .mpdне кешируется—
.ts, .m4s (live)не кешируется—
.ts, .m4s (VOD)30 сутокпуть
.mp4, .webm30 сутокпуть + Range
.js, .css1 годпуть
.jpg, .webp, .avif90 сутокпуть
Остальноепо заголовкам источникапуть

Подписанные ссылки

Ссылку можно ограничить по времени жизни и IP-адресу. Подпись считается на вашей стороне, узел её проверяет:

import hmac, hashlib, base64, time

def sign(path, secret, ttl=3600):
    exp = int(time.time()) + ttl
    raw = f"{path}{exp}".encode()
    mac = hmac.new(secret.encode(), raw, hashlib.sha256).digest()
    sig = base64.urlsafe_b64encode(mac).decode().rstrip("=")
    return f"{path}?exp={exp}&sig={sig}"

REST API

МетодПутьНазначение
GET/v1/resourcesСписок ресурсов
POST/v1/resourcesСоздать ресурс
PATCH/v1/resources/{id}Изменить настройки
POST/v1/resources/{id}/purgeСбросить кеш
GET/v1/resources/{id}/statsМетрики за период
GET/v1/edge-rangesДиапазоны адресов узлов

Токен передаётся заголовком Authorization: Bearer <token>. Лимит — 120 запросов в минуту на проект.