SkyStream API

Отправить со всех аккаунтов

POST/chat-panels/{id}/broadcast

Отправляет одно сообщение с каждого аккаунта панели и возвращает итог по аккаунтам. Аккаунт, который в этот момент заменялся, — в итоге с sent: false и причиной account_unavailable; аккаунты без связи с чатом в итог не попадают — сколько их, видно по состоянию панели. Повтор запроса отправит сообщения второй раз.

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

pixel_mira не подписан на канал в режиме «только для фолловеров».

{  "sent": 2,  "failed": 1,  "total_sent": 27,  "results": [    {      "account": "fox_runner",      "sent": true,      "reason": null    },    {      "account": "night_owl_77",      "sent": true,      "reason": null    },    {      "account": "pixel_mira",      "sent": false,      "reason": "followers_only"    }  ]}