SkyStream API

Изменить запуск

PATCH/channels/{id}/run

Меняет работающий запуск: число зрителей, доли списка и рейда, плавающий онлайн. Новые значения сохраняются и в настройках канала (число зрителей — в start_viewers), и следующий запуск начнётся с них.

Запрос задаёт значения, а не прибавляет их, поэтому повторить его безопасно.

Право ключа: 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

PATCH/channels/ch_12/run
curl https://api.skystream.su/app/v1/channels/ch_12/run \  -X PATCH \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40" \  -H "Content-Type: application/json" \  -d '{    "viewers": 120  }'
bash, zshКлюч — в переменной API_KEY
Ответ

Новое число зрителей сохранено и в start_viewers настроек канала.

{  "id": "ch_12",  "platform": "twitch",  "name": "example_channel",  "viewers": 150,  "temporary": false,  "expires_at": "2026-12-31T21:00:00.000Z",  "run": {    "id": "run_345",    "status": "running",    "viewers": 120,    "active_viewers": 120,    "started_at": "2026-10-05T16:02:11.000Z",    "ends_at": "2026-10-06T06:02:11.000Z"  }}