SkyStream API

Купить награду (Twitch)

POST/chat-panels/{id}/rewards/{reward_id}/redeem

Покупает награду канала за баллы указанного аккаунта. Баллы списываются сразу и не возвращаются.

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

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

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

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

Авторизация

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

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

Где: header

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

id*string

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

reward_id*string

Id награды из GET /chat-panels/{id}/rewards.

Длина1 <= length <= 100

Заголовки

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/rewards/9f1c2e4a-1b7d-4c55-9a43-2f0e6c1d8b21/redeem
curl https://api.skystream.su/app/v1/chat-panels/cp_12/rewards/9f1c2e4a-1b7d-4c55-9a43-2f0e6c1d8b21/redeem \  -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40" \  -H "Content-Type: application/json" \  -d '{    "account": "fox_runner",    "text": "Daft Punk — One More Time"  }'
bash, zshКлюч — в переменной API_KEY
Ответ

С fox_runner списано 2000 баллов канала.

{  "account": "fox_runner",  "reward": {    "id": "9f1c2e4a-1b7d-4c55-9a43-2f0e6c1d8b21",    "title": "Выбрать песню",    "cost": 2000  },  "redemption_id": "e7d6c5b4-a3f2-4e1d-9c0b-8a7f6e5d4c3b"}