SkyStream API

Запустить зрителей

POST/channels/{id}/start

Запускает зрителей на канале. Число зрителей — start_viewers из настроек канала (по умолчанию — потолок канала), разгон и прочее — тоже из настроек. Если эфира нет, запуск ждёт его в статусе waiting.

Для разового канала срок запуска задаётся полем duration_minutes. Обычный канал работает до остановки или до общей автоостановки, заданной владельцем сервиса; момент остановки — run.ends_at.

Право ключа: viewers — запуски зрителей.

Частота: класс «изменение» — 30 запросов в минуту на ключ, 60 на аккаунт.

Idempotency-Key: необязателен; с ним повтор запроса безопасен.

Авторизация

bearerAuth
АвторизацияBearer <ключ>

Ключ API из панели. Только в заголовке Authorization: ключ в строке запроса отклоняется.

Где: header

Параметры адреса

id*string

Id канала, например ch_12.

Заголовки

Idempotency-Key?string

Ключ идемпотентности: от 8 до 128 знаков из латинских букв, цифр и символов _ : . -. Повтор запроса с тем же ключом возвращает сохранённый ответ. Ключ хранится 24 часа.

Шаблон^[A-Za-z0-9_:.\-]+$
Длина8 <= length <= 128

Тело запроса

application/json

Типы TypeScript

Тип request body для TypeScript.

Запуск зрителей. Тело можно не передавать.

Тело ответа

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

POST/channels/ch_12/start

Тело можно не передавать. Число зрителей и остальное — из настроек канала; срок — общая автоотмена.

curl https://api.skystream.su/app/v1/channels/ch_12/start \  -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40"
bash, zshКлюч — в переменной API_KEY
Ответ

Сразу после запуска status — waiting: если эфир идёт, запуск выйдет на канал в течение минуты (событие run.live).

{  "id": "ch_12",  "platform": "twitch",  "name": "example_channel",  "viewers": 150,  "temporary": false,  "expires_at": "2026-12-31T21:00:00.000Z",  "run": {    "id": "run_346",    "status": "waiting",    "viewers": 150,    "active_viewers": 0,    "started_at": "2026-10-05T17:41:05.000Z",    "ends_at": "2026-10-06T07:41:05.000Z"  }}