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Панель или нода не ответили — повторите позже