SkyStream API

Удалить график

DELETE/graphs/{id}

Удаляет график. График, назначенный каналам, удаляется только с force=true: назначения снимаются, и каналы, в том числе с идущими запусками, возвращаются к обычным настройкам онлайна. Без force такой запрос отклоняется с ошибкой graph_in_use, и ничего не меняется.

Право ключа: channels — каналы и их настройки.

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

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

Авторизация

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

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

Где: header

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

id*string

Идентификатор графика.

Параметры строки запроса

force?string

true — удалить и график, назначенный каналам: назначения снимутся, каналы вернутся к обычным настройкам онлайна. Без него такой график не удаляется (graph_in_use).

Одно из значений

  • "true"
  • "false"

Заголовки

Idempotency-Key?string

Ключ идемпотентности: от 8 до 128 знаков из латинских букв, цифр и символов _ : . -. Повтор запроса с тем же ключом возвращает сохранённый ответ. Ключ хранится 24 часа.

Шаблон^[A-Za-z0-9_:.\-]+$
Длина8 <= length <= 128

Тело ответа

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

DELETE/graphs/gr_12?force=true
curl "https://api.skystream.su/app/v1/graphs/gr_12?force=true" \  -X DELETE \  -H "Authorization: Bearer $API_KEY" \  -H "Idempotency-Key: 7c0a5f4e-2b1d-4c9e-9a51-3f6d8e2b1c40"
bash, zshКлюч — в переменной API_KEY
Ответ

С force=true график снят с канала ch_12.

{  "id": "gr_3",  "deleted": true,  "unassigned_channel_ids": [    "ch_12"  ]}