hosting

DELETE `/v1/sites/{siteId}/transfer`

Withdraw this site's pending transfer offer.

Autentifikacija

Pošaljite API ključ kao nosivi token. Ključ mora imati dozvolu sites.view; ključ bez nje se odbija s kodom 403, a ne 404.

Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

curl -X DELETE https://api.zinndigital.com/v1/sites/{siteId}/transfer \
  -H "Authorization: Bearer zdk_live_…"

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

The sender takes the offer back. Takes no body and returns the offer, which will read cancelled. ⛔ DELETE on the offer, not POST …/cancel — the resource being removed is the pending offer, and giving the undo its own noun means no request body can turn a withdrawal into something else by being slightly wrong. 404 when there is no pending offer. Requires sites.view and sites.transfer.

Parametri

Naziv	Vrsta	Obavezno	Što je to
`siteId (path)`	`Uuid`	Da	Site ID (UUIDv7).

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_name`	`string`	Ne	The site's name as it was when the offer was made. Snapshotted onto the offer, not read live: while a transfer is pending the site still belongs to the sender, and reading it live…
`primary_domain`	`string`	Ne	The site's domain as it was when the offer was made. Snapshotted, as above.
`direction`	`string<incoming, outgoing>`	Da	From this caller's point of view. Computed per request, never stored — the same row is outgoing to one party and incoming to the other.
`status`	`string<pending, accepted, declined, cancelled, expired, failed>`	Da	Five terminal states rather than one, because why an offer ended is what support is actually asked. `failed` means it was accepted and could not complete; nothing moved.
`include_domain`	`boolean`	Da	Whether the domain, its DNS and its mail travel with the site.
`recipient_email`	`string`	Ne	Only populated for the sender. To the receiver it is their own address and carries no information; to anyone else it would be a third party's email address in a row two…
`message`	`string`	Ne	—
`expires_at`	`string`	Da	An unaccepted offer expires fourteen days after it is made.
`term_ends_at`	`string`	Ne	—
`renewal_amount_minor`	`integer`	Ne	—
`renewal_currency`	`string`	Ne	—
`created_at`	`string`	Da	—
`decided_at`	`string`	Ne	—
`failure_reason`	`string`	Ne	Why a `failed` transfer could not complete. Empty otherwise.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 404 · 409 · 429

DELETE /v1/sites/{siteId}/transfer