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

Запуск — это зрители, работающие на канале. У канала бывает не больше одного запуска. Для запуска у ключа должно быть право viewers.

ЗапуститьСкопировать ссылку на раздел

curl https://api.skystream.su/app/v1/channels/ch_12/start \  -X POST \  -H "Authorization: Bearer $API_KEY"

Тело не требуется. Число зрителей — start_viewers из настроек канала, по умолчанию — потолок канала. Разгон, плавающий онлайн, график и остальное тоже берутся из настроек. Ответ — канал с запуском в поле run:

{  "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": "waiting",    "viewers": 100,    "active_viewers": 0,    "started_at": "2026-09-29T12:00:00.000Z",    "ends_at": "2026-09-30T12:00:00.000Z"  }}

Если запуск уже идёт, запрос отклоняется с ошибкой 409 run_already_active.

Состояние запускаСкопировать ссылку на раздел

Запуск не завершается с концом эфира. Когда эфир заканчивается, зрители останавливаются, запуск переходит в waiting и продолжается со следующим эфиром — пока его не остановят или не наступит ends_at.

Чтобы следить за запусками, периодически читайте GET /channels: один запрос возвращает все каналы с их запусками. Учитывайте ограничения частоты: для дашборда достаточно запроса раз в 15–30 секунд.

ИзменитьСкопировать ссылку на раздел

Работающий запуск меняется без остановки:

curl https://api.skystream.su/app/v1/channels/ch_12/run \  -X PATCH \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "viewers": 80,    "fluctuation_percent": 15  }'

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

Если сервис запусков применил изменение не целиком, API отвечает 502 run_partially_updated. Повторите запрос.

Потолок канала — PATCH /channels/{id} с полем viewers — ограничивает все запуски канала: идущий запуск с большим числом зрителей опустится до нового потолка.

ОстановитьСкопировать ссылку на раздел

curl https://api.skystream.su/app/v1/channels/ch_12/stop \  -X POST \  -H "Authorization: Bearer $API_KEY"

{  "channel_id": "ch_12",  "stopped": true,  "channel_deleted": false}

Если запуска нет, запрос отклоняется с ошибкой 409 run_not_active. Разовый канал удаляется вместе с запуском; об этом говорит channel_deleted: true. Подробнее — в руководстве Разовый запуск.

Срок запускаСкопировать ссылку на раздел

Запуск останавливается сам в момент run.ends_at. Наибольший срок одного запуска задаёт владелец сервиса. У обычного канала этот срок назначается автоматически при запуске; ends_at равно null, только если владелец сервиса отключил автоматическую остановку. У разового канала срок задаётся при запуске.

Кроме того, запуск останавливается, когда истекает срок лимита аккаунта.

ИсторияСкопировать ссылку на раздел

GET /runs возвращает запуски аккаунта от новых к старым, постранично, в том числе завершённые:

curl "https://api.skystream.su/app/v1/runs?channel_id=ch_12&limit=20" \  -H "Authorization: Bearer $API_KEY"

У завершённого запуска status: "stopped" и причина в stop_reason:

duration_seconds — сколько длился запуск, включая время ожидания эфира.

ОшибкиСкопировать ссылку на раздел