SkyStream API

Завести канал

POST/channels

Заводит канал на площадке с заданным потолком зрителей. Канал проверяется на площадке: канала, которого на ней нет, завести нельзя.

Разовый канал (temporary: true) нужен для одного запуска с заданным сроком. Он удаляется, когда его запуск остановлен; канал, который не запустили в течение трёх минут, удаляется при следующем запросе к каналам. Подробнее — в руководстве «Разовый запуск».

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

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

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

Авторизация

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

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

Где: header

Заголовки

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

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

Запуска ещё нет. Срок канала совпадает со сроком лимита.

{  "id": "ch_12",  "platform": "twitch",  "name": "example_channel",  "viewers": 150,  "temporary": false,  "expires_at": "2026-12-31T21:00:00.000Z",  "run": null}