Документация
Подключение, структура путей, кеширование и 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 суток.
streaming. Он отключает буферизацию и снимает ограничение
на время ответа.Правила кеширования
| Тип контента | TTL по умолчанию | Ключ кеша |
|---|---|---|
.m3u8, .mpd | не кешируется | — |
.ts, .m4s (live) | не кешируется | — |
.ts, .m4s (VOD) | 30 суток | путь |
.mp4, .webm | 30 суток | путь + Range |
.js, .css | 1 год | путь |
.jpg, .webp, .avif | 90 суток | путь |
| Остальное | по заголовкам источника | путь |
Подписанные ссылки
Ссылку можно ограничить по времени жизни и 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 запросов в минуту
на проект.