SkyStream API

Рассчитать онлайн по графику

GET/graphs/{id}/preview

Считает, сколько зрителей будет держаться по минутам, если на канале с этим графиком идёт запуск на viewers зрителей. Расчёт — по той же кривой и с тем же округлением до потоков зрителей, что у сервиса запусков.

ends_at_minute — минута, на которой зрители снимаются до следующего эфира. Так бывает, когда доиграл спад (after_end: decay) или кривая опустилась так низко, что от viewers не остаётся ни одного зрителя: точка с малой долей посреди кривой при небольшом запуске снимает зрителей раньше конца кривой. Нулевая минута — старт: на ней поднимается не меньше одного потока зрителей, и зрители не снимаются.

Расчёт — для графика, который назначен до старта запуска. График, назначенный посреди эфира, начинает отсчёт с момента назначения, и если его нулевая минута даёт ноль зрителей, зрители снимаются сразу.

Расчёт приблизительный: мелкие отклонения от цели сервис запусков не исправляет, чтобы не дёргать зрителей каждую минуту.

Право ключа: не требуется, запрос доступен любому ключу.

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

Авторизация

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

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

Где: header

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

id*string

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

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

viewers*integer

Число зрителей запуска (run.viewers): от него считаются доли кривой. От 1 до 100000.

Диапазон1 <= value <= 100000
step_minutes?integer

Шаг отсчётов, минуты: от 1 до 60, по умолчанию 1.

Диапазон1 <= value <= 60
По умолчанию1
platform?string

Площадка канала: от неё зависит, сколько зрителей поднимается на старте. По умолчанию twitch.

По умолчанию"twitch"

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

  • "twitch"
  • "kick"

Тело ответа

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

GET/graphs/gr_12/preview?viewers=150&step_minutes=30
curl "https://api.skystream.su/app/v1/graphs/gr_12/preview?viewers=150&step_minutes=30" \  -H "Authorization: Bearer $API_KEY"
bash, zshКлюч — в переменной API_KEY
Ответ

Запуск на 150 зрителей с «Вечерним эфиром». Доли округляются вверх до потока зрителей; на 270-й минуте спад доигрывает, и зрители снимаются до следующего эфира.

{  "graph_id": "gr_3",  "viewers": 150,  "step_minutes": 30,  "platform": "twitch",  "ends_at_minute": 270,  "samples": [    {      "minute": 0,      "percent": 40,      "viewers": 68    },    {      "minute": 30,      "percent": 80,      "viewers": 136    },    {      "minute": 60,      "percent": 92.5,      "viewers": 150    },    {      "minute": 90,      "percent": 100,      "viewers": 150    },    {      "minute": 120,      "percent": 100,      "viewers": 150    },    {      "minute": 150,      "percent": 100,      "viewers": 150    },    {      "minute": 180,      "percent": 100,      "viewers": 150    },    {      "minute": 210,      "percent": 85,      "viewers": 136    },    {      "minute": 240,      "percent": 70,      "viewers": 119    },    {      "minute": 270,      "percent": 0,      "viewers": 0    }  ]}