compute

POST `/v1/compute/servers/{serverId}/plan`

Buy one paid option for this machine.

Autentizace

Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/plan \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "offer_id": <Uuid> }'

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

⛔⛔ Chargeable twice over, and both are immediate. It debits Zinn®'s reseller balance at the provider and starts a recurring charge on the customer, so it sits behind billing.payment.manage rather than sites.create. The provider offers no idempotency header on this operation, so the request is keyed by (machine, option) on our side and a repeat returns the original purchase rather than buying a second one. 422 when the machine cannot carry the option — cPanel below 2 GB, a second cPanel licence, backups already on.

Parametry

Název	Typ	Požadováno	Co to je
`serverId (path)`	`Uuid`	Ano	The server's id, as `listComputeServers` reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine.

Tělo požadavku

Název	Typ	Požadováno	Co to je
`offer_id`	`Uuid`	Ano	The offer to buy, from `getComputeServerPlan`'s `available` or `getVpsAddonOptions`. ⛔ There is deliberately no price field: a price sent by a client is not read, and the charge…

Odpověď

Název	Typ	Požadováno	Co to je
`data`	`ComputeAddonPurchase`	Ano	One paid option a tenant actually bought against one machine. ⛔ `status` is `cancelling`, not `ended`, after a removal. The thing is still running and still ours to pay for until…

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422 · 429 · 503

POST /v1/compute/servers/{serverId}/plan