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… |
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