hosting

DELETE `/v1/private-network/devices/{seatId}`

Revoke a device.

Упълномощаване

Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

curl -X DELETE https://api.zinndigital.com/v1/private-network/devices/{seatId} \
  -H "Authorization: Bearer zdk_live_…"

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в 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.

Грешки, които този крайpoint може да върне

401 · 403 · 404

DELETE /v1/private-network/devices/{seatId}