STREAMGROW API

Выбрать значок аккаунта

PUT/account-lists/{id}/accounts/{account_id}/badge

Выбирает глобальный значок Twitch из доступных аккаунту (available в GET …/badges). Выбор сохраняется в итоге проверки аккаунта и виден в check.badge.

Право ключа: accounts — шаблоны аккаунтов и сообщений.

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

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

Авторизация

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

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

Где: header

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

id*string

Идентификатор шаблона аккаунтов.

account_id*string

Идентификатор аккаунта в шаблоне.

Заголовки

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

PUT/account-lists/al_12/accounts/acc_3f9a2c1b7d4e5f60/badge
curl https://api.streamgrow.me/app/v1/account-lists/al_12/accounts/acc_3f9a2c1b7d4e5f60/badge \  -X PUT \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40" \  -H "Content-Type: application/json" \  -d '{    "set_id": "premium"  }'
bash, zshКлюч — в переменной API_KEY
Ответ
{  "account_id": "acc_3f9a2c1b7d4e5f60",  "selected": {    "set_id": "premium",    "version": "1",    "title": "Prime Gaming",    "image_url": "https://static-cdn.jtvnw.net/badges/v1/bbbe0db0-a598-423e-86d0-f9fb98ca1933/1"  },  "displayed": [    {      "set_id": "premium",      "version": "1",      "title": "Prime Gaming",      "image_url": "https://static-cdn.jtvnw.net/badges/v1/bbbe0db0-a598-423e-86d0-f9fb98ca1933/1"    }  ],  "available": [    {      "set_id": "glitchcon2020",      "version": "1",      "title": "GlitchCon 2020",      "image_url": "https://static-cdn.jtvnw.net/badges/v1/1d4b03b9-51ea-42c9-8f29-698e3c85be3d/1"    },    {      "set_id": "premium",      "version": "1",      "title": "Prime Gaming",      "image_url": "https://static-cdn.jtvnw.net/badges/v1/bbbe0db0-a598-423e-86d0-f9fb98ca1933/1"    }  ]}