Разработчикам

Три способа подключить нашу сеть к вашему пайплайну: REST API, CLI для загрузки артефактов и webhooks на события.

Главная → Разработчикам

REST API

  • POST /v1/releases — создать релиз и указать файлы;
  • POST /v1/releases/{id}/prewarm — разогреть кэш узлов;
  • GET /v1/stats/{id} — объём, регионы, доля кэша, p95;
  • POST /v1/keys — ключи доступа для тестеров и партнёров.

CLI

patchflow upload ./build/*.pak --release=1.14.2 --prewarm
patchflow stats --release=1.14.2 --by=region

Докачка при обрыве, до 16 потоков, ограничение полосы, загрузка ночью по расписанию.

Webhooks

  • release.prewarmed — кэш узлов готов;
  • release.published — файлы доступны клиентам;
  • node.degraded / node.recovered — состояние узла;
  • подпись HMAC-SHA256, повторные попытки до 24 часов.

Форматы отдачи

  • HTTPS по диапазонам запросов, докачка;
  • HLS для видео, сегменты по 4–10 с;
  • торрент-файлы для крупных открытых сборок (по запросу);
  • лимиты скорости и геофильтры по договору.

Пример

curl -X POST https://api.patchflow.store/v1/releases \
  -H "X-Partner-Key: <key>" -H "Content-Type: application/json" \
  -d '{"name":"1.14.2","files":["client-1.14.2.pak"],"regions":["HK","SG","JP","DE"]}'