compute
POST /v1/panels/connections/{connectionId}/check
Re-probe what this panel can actually do.
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}/check \
-H "Authorization: Bearer zdk_live_…"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
⛔⛔ **Rewrites `provedCapabilities` from what the panel DEMONSTRATED**, never from what the adapter can express. A Plesk box can answer every read perfectly and refuse `/cli/*/call` outright, because the command-line gateway is separately licensed and separately permissioned — and both one-click login and licence installation go through it. Re-probing matters because the answer changes without telling us: the customer's own administrator can restrict it, or the licence can lapse. ⛔ A failed check CLEARS `provedCapabilities` rather than keeping yesterday's list, so the screen stops offering buttons against a panel we can no longer reach. Requires `connections.manage`.
Parametreler
| Ad | Tür | Zorunlu | Ne olduğu |
|---|---|---|---|
connectionId (path) | Uuid | Evet | The connected panel's id, as `listPanelConnections` reports it. |
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 lic… |
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 ins… |
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 pla… |
Bu uç noktanın dönderebileceği hatalar
401 · 403 · 404 · 429