SOURHOST.NET
API / Довідник методів / FastDL

FastDL

Дані FastDL, стиснення й зміна тарифу.

Адреса:https://sourhost.net/api/v1·Авторизація: Authorization: Bearer sh_live_…
GET/projects/:id/services/:serviceId/fastdlPOST/projects/:id/services/:serviceId/fastdl/compressPOST/projects/:id/services/:serviceId/fastdl/planGET/projects/:id/fastdl/free-starter
GET/projects/:id/services/:serviceId/fastdl

Дані FastDL

Адреса для sv_downloadurl, доступ для завантаження, зайняте місце.

Право: fastdl:read
Параметри
idобовʼязковийpath · stringНомер проєкту (з GET /projects) або тікета
serviceIdобовʼязковийpath · stringНомер послуги (з GET /projects/:id/services)
Приклад запиту
curl "https://sourhost.net/api/v1/projects/12/services/34/fastdl" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"
Відповідь
204 Порожня відповідь
POST/projects/:id/services/:serviceId/fastdl/compress

Стиснути файли

Пакує файли в .bz2.

Право: fastdl:write
Параметри
idобовʼязковийpath · stringНомер проєкту (з GET /projects) або тікета
serviceIdобовʼязковийpath · stringНомер послуги (з GET /projects/:id/services)
Приклад запиту
curl -X POST "https://sourhost.net/api/v1/projects/12/services/34/fastdl/compress" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"
Відповідь
204 Порожня відповідь
POST/projects/:id/services/:serviceId/fastdl/plan

Змінити тариф FastDL

Право: billing:spendСписує гроші · потрібен Idempotency-Key
Параметри
idобовʼязковийpath · stringНомер проєкту (з GET /projects) або тікета
serviceIdобовʼязковийpath · stringНомер послуги (з GET /projects/:id/services)
Приклад запиту
curl -X POST "https://sourhost.net/api/v1/projects/12/services/34/fastdl/plan" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: extend-34-2026-11" \
  -d '{"planCode":"fastdl-25"}'
Відповідь
HTTP
HTTP/2 200 OK
{
  "tariff": "FastDL 25 ГБ",
  "price": 150,
  "storageGb": 25
}
Помилки методу
400idempotency_key_requiredНемає заголовка Idempotency-Key
402insufficient_balanceНе вистачає грошей на балансі
403token_spend_limitПеревищить ліміт витрат токена
409idempotency_in_progressЗапит із цим ключем ще виконується
GET/projects/:id/fastdl/free-starter

Безкоштовний FastDL проєкту

Право: fastdl:read
Параметри
idобовʼязковийpath · stringНомер проєкту (з GET /projects) або тікета
Приклад запиту
curl "https://sourhost.net/api/v1/projects/12/fastdl/free-starter" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"
Відповідь
204 Порожня відповідь

Загальні помилки

Будь-який метод може відповісти так. Докладніше про помилки

400bad_requestНевірне тіло чи параметри
401token_invalidТокен невірний, відкликаний або прострочений
403token_scope_missingУ токена немає потрібного права
403token_project_forbiddenПроєкт чи послуга поза обмеженнями токена
404not_foundНемає такого проєкту, послуги чи об’єкта
429token_rate_limitedЗабагато запитів, див. Retry-After
503upstream_unavailableПанель або нода не відповіли — повторіть пізніше