Обзор
Программный доступ к личному лимиту зрителей, каналам, запускам и заказам услуг.
API даёт программам доступ к тому же, что вы делаете в панели SkyStream: читать состояние лимита и каналов, заводить и настраивать каналы, запускать и останавливать зрителей, заказывать услуги со своего счёта и управлять чат-панелью.
Типичные задачи:
- дашборд или бот, который показывает занятость пула и идущие запуски;
- запуск зрителей по расписанию эфиров или по событию из другой системы;
- разовые запуски на заданный срок для ваших собственных клиентов;
- заказ просмотров, фолловеров и чат-услуг из вашей учётной системы;
- бот, который пишет в чат, голосует в опросах и ставит баллы канала от аккаунтов чат-панели.
Как устроен API
| Что | Как устроено |
|---|---|
| Адрес | https://api.skystream.su/app/v1 |
| Протокол | HTTPS, тела запросов и ответов — JSON в кодировке UTF-8 |
| Аутентификация | Ключ из панели в заголовке Authorization: Bearer <ключ> |
| Права | Чтение доступно любому ключу; изменения — по правам ключа |
| Деньги | Целые копейки: {"amount": 15000, "currency": "RUB"} |
| Время | ISO 8601 в UTC: 2026-09-29T12:00:00.000Z |
| Идентификаторы | Строки с префиксом вида объекта: ch_12 — канал, run_345 — запуск |
| Ошибки | Объект error с машинным кодом code и описанием message |
API предназначен для серверов. Запросы из браузера не поддерживаются: ключ, записанный в код веб-страницы, доступен любому её посетителю. Подробнее — в разделе Безопасность ключей.
С чего начать
Быстрый старт
Выпустить ключ, выполнить первый запрос и запустить зрителей.
Аутентификация
Как передавать ключ и какие ответы бывают при ошибке.
Руководства
Запуск зрителей, разовые запуски, настройки каналов, заказы, чат-панель.
Справочник
Все операции, поля запросов и ответов.
Операции
Аккаунт
| Запрос | Что делает | Право |
|---|---|---|
GET /account | Получить состояние аккаунта | — |
Каналы
| Запрос | Что делает | Право |
|---|---|---|
GET /channels | Получить список каналов | — |
POST /channels | Завести канал | channels |
GET /channels/{id} | Получить канал | — |
PATCH /channels/{id} | Изменить потолок канала | channels |
DELETE /channels/{id} | Удалить канал | channels |
GET /channels/{id}/settings | Получить настройки канала | — |
PATCH /channels/{id}/settings | Изменить настройки канала | channels |
GET /graphs | Получить список графиков | — |
POST /graphs | Создать график | channels |
GET /graphs/{id} | Получить график | — |
PATCH /graphs/{id} | Изменить график | channels |
DELETE /graphs/{id} | Удалить график | channels |
GET /graphs/{id}/preview | Рассчитать онлайн по графику | — |
Запуски
| Запрос | Что делает | Право |
|---|---|---|
POST /channels/{id}/start | Запустить зрителей | viewers |
PATCH /channels/{id}/run | Изменить запуск | viewers |
POST /channels/{id}/extend | Продлить разовый запуск | viewers |
POST /channels/{id}/stop | Остановить запуск | viewers |
GET /runs | Получить историю запусков | — |
Цены и заказы
| Запрос | Что делает | Право |
|---|---|---|
GET /prices | Получить ставки | — |
GET /orders | Получить список заказов | — |
GET /orders/{id} | Получить заказ | — |
POST /orders/views | Заказать просмотры | billing |
POST /orders/followers | Заказать фолловеров | billing |
POST /orders/chat-bots | Заказать чат-ботов | billing |
POST /orders/chat-panel | Заказать чат-панель | billing |
POST /orders/{id}/extend | Продлить заказ | billing |
POST /orders/{id}/cancel | Отменить заказ | billing |
Чат-панель
| Запрос | Что делает | Право |
|---|---|---|
GET /chat-panels/{id} | Получить состояние чат-панели | — |
PATCH /chat-panels/{id} | Изменить авто-ротацию и текущий аккаунт | chat_panel |
GET /chat-panels/{id}/accounts | Получить аккаунты с подробностями | — |
PUT /chat-panels/{id}/accounts/{login}/pin | Закрепить аккаунт | chat_panel |
DELETE /chat-panels/{id}/accounts/{login}/pin | Открепить аккаунт | chat_panel |
POST /chat-panels/{id}/accounts/{login}/follow | Подписать аккаунт на канал | chat_panel |
GET /chat-panels/{id}/messages | Получить последние сообщения чата (Kick) | — |
POST /chat-panels/{id}/messages | Отправить сообщение | chat_panel |
POST /chat-panels/{id}/broadcast | Отправить со всех аккаунтов | chat_panel |
GET /chat-panels/{id}/rewards | Получить награды канала (Twitch) | — |
POST /chat-panels/{id}/rewards/{reward_id}/redeem | Купить награду (Twitch) | chat_panel |
GET /chat-panels/{id}/poll | Получить опрос канала (Twitch) | — |
POST /chat-panels/{id}/poll/votes | Проголосовать в опросе (Twitch) | chat_panel |
POST /chat-panels/{id}/poll/votes/cancel | Остановить раздачу голосов (Twitch) | chat_panel |
GET /chat-panels/{id}/prediction | Получить предсказание канала (Twitch) | — |
POST /chat-panels/{id}/prediction/bets | Сделать ставки (Twitch) | chat_panel |
POST /chat-panels/{id}/prediction/bets/cancel | Остановить раздачу ставок (Twitch) | chat_panel |
GET /chat-panels/{id}/share-link | Получить ссылку общего доступа | chat_panel |
POST /chat-panels/{id}/share-link/rotate | Заменить ссылку общего доступа | chat_panel |
Операции
| Запрос | Что делает | Право |
|---|---|---|
GET /transactions | Получить список операций | — |
События
| Запрос | Что делает | Право |
|---|---|---|
GET /events | Получить список событий | — |
GET /events/{id} | Получить событие | — |
Что недоступно через API
- Выпуск ключей, профиль, почта, пароль, второй фактор и сессии. Это доступ к самому аккаунту, и управлять им можно только в панели.
- Пополнение счёта. Оплата требует подтверждения на странице платёжной системы.
- Магазин аккаунтов.
- Включение автопросмотров и шаблоны своих аккаунтов и сообщений. Эти возможности остаются в панели.
- Чтение чата Twitch. Чат читается напрямую у площадки — см. Чат-панель.