FastDL

FastDL details, compression and plan changes.

Base URL:https://sourhost.net/api/v1·Auth: Authorization: Bearer sh_live_…

GET/projects/:id/services/:serviceId/fastdl— FastDL details POST/projects/:id/services/:serviceId/fastdl/compress— Compress files POST/projects/:id/services/:serviceId/fastdl/plan— Change the FastDL plan GET/projects/:id/fastdl/free-starter— The project's free FastDL

GET/projects/:id/services/:serviceId/fastdl

FastDL details

The sv_downloadurl address, upload access, storage used.

Scope: fastdl:read

Parameters

`id`required	path · string	Project number (from GET /projects), or ticket number
`serviceId`required	path · string	Service number (from GET /projects/:id/services)

Example request

curl "https://sourhost.net/api/v1/projects/12/services/34/fastdl" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Response

204 Empty response

POST/projects/:id/services/:serviceId/fastdl/compress

Compress files

Packs the files into .bz2.

Scope: fastdl:write

Parameters

`id`required	path · string	Project number (from GET /projects), or ticket number
`serviceId`required	path · string	Service number (from GET /projects/:id/services)

Example request

curl -X POST "https://sourhost.net/api/v1/projects/12/services/34/fastdl/compress" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Response

204 Empty response

POST/projects/:id/services/:serviceId/fastdl/plan

Change the FastDL plan

Scope: billing:spendSpends money · needs an Idempotency-Key

Parameters

`id`required	path · string	Project number (from GET /projects), or ticket number
`serviceId`required	path · string	Service number (from GET /projects/:id/services)

Example request

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"}'

Response

HTTP

HTTP/2 200 OK
{
  "tariff": "FastDL 25 ГБ",
  "price": 150,
  "storageGb": 25
}

Method errors

400	`idempotency_key_required`	No Idempotency-Key header
402	`insufficient_balance`	Not enough money on the balance
403	`token_spend_limit`	Would exceed the token’s spending limit
409	`idempotency_in_progress`	A request with this key is still running

GET/projects/:id/fastdl/free-starter

The project's free FastDL

Scope: fastdl:read

Parameters

idrequired path · string Project number (from GET /projects), or ticket number

Example request

curl "https://sourhost.net/api/v1/projects/12/fastdl/free-starter" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Response

204 Empty response

Common errors

Any method can answer with these. More on errors

400	`bad_request`	Invalid body or parameters
401	`token_invalid`	The token is wrong, revoked or expired
403	`token_scope_missing`	The token lacks the scope
403	`token_project_forbidden`	The project or service is outside the token’s limits
404	`not_found`	No such project, service or object
429	`token_rate_limited`	Too many requests, see Retry-After
503	`upstream_unavailable`	The panel or node didn't answer — retry later