Отправить сообщение
/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 Ключ API из панели. Только в заголовке Authorization: ключ в строке запроса отклоняется.
Где: header
Параметры адреса
Id чат-панели — id её заказа: cp_12.
Заголовки
Ключ идемпотентности: от 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
/chat-panels/cp_12/messagescurl 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": "Привет, чат!" }'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}