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

Все защищённые endpoint'ы требуют валидный токен auth в query string и активный cookie сессии браузера.

Публичные endpoint'ы

МетодПутьОписание
GET/healthПроверка состояния сервиса (JSON)
GET/api/v1/info.jsonМетаданные продукта
GET/api/v1/endpoints.jsonКаталог опубликованных маршрутов

Защищённый relay endpoint

Основной шлюз для packet ingest и pull-операций по сессии.

МетодПутьBodyОтвет
POST/stream/relay/hub.php?auth=<token>binary / octet-stream4xx при невалидной сессии (норма)
GET/stream/relay/hub.php?auth=<token>—pull / stream chunk

Обязательные заголовки (клиент)

Accept: */*
Content-Type: application/octet-stream   # для POST ingest
Cookie: session_id=<uuid>
Origin: https://<your-host>/
Referer: https://<your-host>/
User-Agent: Mozilla/5.0 ... Firefox/...
Sec-Fetch-Mode: cors
Sec-Fetch-Site: same-origin

Запрос без авторизации

GET /stream/relay/hub.php HTTP/2

HTTP/2 200
content-type: text/html

# Публичная страница или подсказка об auth (нет активной сессии)

Коды ошибок

КодЗначение
200Публичный статический контент / документация
400Невалидная или просроченная relay-сессия
401Отсутствует auth-токен
405Метод не разрешён для статического маршрута