compute

POST `/v1/panels/connections/{connectionId}/install-licence`

Install a licence we bought onto this panel.

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar connections.manage iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

curl -X POST https://api.zinndigital.com/v1/panels/connections/{connectionId}/install-licence \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "licence_id": <string> }'

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

⛔⛔ Buying a licence and installing it are different acts, and doing only the first is a recurring charge for nothing. This is the step that makes a purchase useful. ⭐ The panel is read back afterwards rather than the call being trusted, so the response states what the panel now actually holds. Requires connections.manage.

Parametreler

Ad	Tür	Zorunlu	Ne olduğu
`connectionId (path)`	`Uuid`	Evet	The connected panel's id, as `listPanelConnections` reports it.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`licence_id`	`string`	Evet	A licence this organisation holds.

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`id`	`Uuid`	Evet	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`host`	`string`	Evet	—
`port`	`integer`	Evet	—
`panel`	`string`	Evet	—
`label`	`string`	Evet	—
`licence_id`	`Uuid`	Evet	The licence this panel runs on, where we sold it. Null is a supported case, not an error: a customer may connect a panel they licensed elsewhere.
`proved_capabilities`	`string[]`	Evet	⛔⛔ What this CONNECTION demonstrated, not what the adapter can express. A Plesk box can answer every read and refuse `/cli/*/call` outright, and both one-click login and…
`panel_version`	`string`	Evet	—
`panel_hostname`	`string`	Evet	The panel's own hostname, which need not be the host we connect to.
`licence_name`	`string`	Evet	The edition the panel reports it is licensed for.
`verify_tls`	`boolean`	Evet	Whether we verify the panel's TLS certificate. Per connection, because many Plesk boxes present a self-signed certificate on 8443 — the panel's own default before a customer…
`checked_at`	`string`	Evet	⛔ `null` means never checked, which is not the same as failed. A client must render the two differently.
`last_error`	`string`	Evet	Empty when the last check succeeded. Otherwise the reason, which distinguishes we could not reach it from it refused our credential — the two send a customer to opposite…

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 404 · 429 · 503

POST /v1/panels/connections/{connectionId}/install-licence