domains
DELETE /v1/domains/{domainId}/disconnect
Stop hosting a connected domain's DNS, and delete its zone.
Doğrulama
API açarını bearer token kimi göndərin. Açar domains.dns.manage icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X DELETE https://api.zinndigital.com/v1/domains/{domainId}/disconnect \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
The other half of connectDomain, and not optional: a create with no delete is how an estate fills with dead zones — config nobody serves, still counting against a provider's zone cap and indistinguishable from live config later. Removes the zone at the DNS provider, releases the provider-account placement so the pool stops counting it, then deletes the row and emits domain.disconnected. ⛔ Not domain.deleted (W42-R): that event renders to the customer as a registry release — "it is no longer yours, anyone may now register it" — which is a statement about a registration we held. Stopping DNS hosting for a name somebody else registered is a statement about our service, and the two were one event until 2026-09-09. The zone goes first: if the provider call fails this is a 503 and nothing is changed, because deleting the row first would strand the zone with nothing left pointing at it. A zone already absent at the provider is a success, not an error — otherwise a row could exist that nobody can ever remove. ⛔ Only a connected domain. One registered with us is held at a registrar with a renewal cycle attached, so removing it here would orphan the registration rather than end it — that is the transfer-out/expiry lifecycle. Attempting it is a 409. Requires domains.dns.manage.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
domainId (path) | Uuid | Bəli | The domain's id. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 409 · 429 · 503