SkyStream API

Подписать аккаунт на канал

POST/chat-panels/{id}/accounts/{login}/follow

Подписывает аккаунт панели на её канал — это нужно, когда канал в режиме «только для фолловеров».

Подписка идёт через площадку и может занять больше минуты, а API ждёт не дольше 25 секунд. Не дождался — отвечает status: pending; подписка при этом продолжается, и итог виден в GET /chat-panels/{id}/accounts?include=following. failed — площадка не дала подписаться; непригодный аккаунт панель заменит сама, в остальных случаях запрос можно повторить позже.

Право ключа: chat_panel — управление чат-панелью.

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

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

Авторизация

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

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

Где: header

Параметры адреса

id*string

Id чат-панели: cp_12.

login*string

Логин аккаунта панели, без учёта регистра.

Шаблон^[A-Za-z0-9_-]{1,40}$

Заголовки

Idempotency-Key?string

Ключ идемпотентности: от 8 до 128 знаков из латинских букв, цифр и символов _ : . -. Повтор запроса с тем же ключом возвращает сохранённый ответ. Ключ хранится 24 часа.

Шаблон^[A-Za-z0-9_:.\-]+$
Длина8 <= length <= 128

Тело ответа

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/chat-panels/cp_8/accounts/pixel_mira/follow
curl https://api.skystream.su/app/v1/chat-panels/cp_8/accounts/pixel_mira/follow \  -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40"
bash, zshКлюч — в переменной API_KEY
Ответ

Ограничение «только для фолловеров» снимется с аккаунта в течение нескольких секунд.

{  "account": "pixel_mira",  "status": "following"}