hosting
DELETE /v1/private-network/devices/{seatId}
Revoke a device.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X DELETE https://api.zinndigital.com/v1/private-network/devices/{seatId} \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Gated on network.private.manage. The row is kept, marked revoked, so the revocation can be evidenced later — a revocation nobody can point at is not much of a control. ⚠️ Access stops when the gateway next syncs its peer set, not at the instant this returns. The dashboard says so rather than implying otherwise. 404 rather than 403 for a device in another tenant — a 403 would confirm it exists.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
seatId (path) | string | Да | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
id | string | Да | — |
label | string | Да | What the customer calls it — "Neil's MacBook". |
address | string | Да | The device's address inside the tunnel. |
status | string<active, revoked> | Да | — |
created_at | string | Да | — |
revoked_at | string | Не | — |
last_seen_at | string | Не | Last handshake the gateway reported. Null until the device first connects, which is what makes "you are paying for five devices and three have never been used" answerable. |
Грешке које ова крајња тачка може вратити
401 · 403 · 404