SkyStream API

Отправить сообщение

POST/chat-panels/{id}/messages

Отправляет сообщение в чат канала с указанного аккаунта, а без account — с текущего. При авто-ротации после отправки текущим становится следующий за отправителем аккаунт — он в current_account ответа. С reply_to сообщение уходит ответом на другое.

Если площадка не приняла сообщение или писать некому, ответ — 200 с sent: false и причиной в reason: это исход отправки, а не ошибка запроса. Аккаунт, ограниченный сам (бан, проверка, скрытие сообщений), панель заменит. Twitch о части отказов сообщает уже после ответа — они появляются в last_send_error состояния панели.

Повтор запроса отправит сообщение второй раз. Чтобы повтор после обрыва связи был безопасен, передавайте Idempotency-Key.

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

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

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

Авторизация

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

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

Где: header

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

id*string

Id чат-панели — id её заказа: cp_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

application/json

POST/chat-panels/cp_12/messages
curl https://api.skystream.su/app/v1/chat-panels/cp_12/messages \  -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40" \  -H "Content-Type: application/json" \  -d '{    "text": "Привет, чат!"  }'
bash, zshКлюч — в переменной API_KEY
Ответ

Авто-ротация включена: следующее сообщение уйдёт с night_owl_77.

{  "sent": true,  "account": "fox_runner",  "message_id": null,  "reason": null,  "retry_after_ms": null,  "current_account": "night_owl_77",  "total_sent": 26}