SkyStream API

Изменить потолок канала

PATCH/channels/{id}

Меняет потолок канала. Если на канале идёт запуск с большим числом зрителей, запуск опускается до нового потолка.

Если сервис запусков не ответил, потолок всё равно меняется, а run.viewers в ответе остаётся прежним. Опустить запуск в этом случае можно запросом PATCH /channels/{id}/run.

Право ключа: channels — каналы и их настройки.

Частота: класс «изменение» — 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

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

Запуск шёл со 150 зрителями и опустился до нового потолка — 100.

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