hosting

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

Withdraw this site's pending transfer offer.

Նույնականացում

Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա sites.view թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

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

Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում

Մանրամասներ

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`.

Պարամետրեր

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`siteId (path)`	`Uuid`	Այո	Site ID (UUIDv7).

Պատասխան

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`id`	`Uuid`	Այո	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_id`	`Uuid`	Այո	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_name`	`string`	Ոչ	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 li…
`primary_domain`	`string`	Ոչ	The site's domain as it was when the offer was made. Snapshotted, as above.
`direction`	`string<incoming, outgoing>`	Այո	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>`	Այո	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`	Այո	Whether the domain, its DNS and its mail travel with the site.
`recipient_email`	`string`	Ոչ	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 orga…
`message`	`string`	Ոչ	—
`expires_at`	`string`	Այո	An unaccepted offer expires fourteen days after it is made.
`term_ends_at`	`string`	Ոչ	—
`renewal_amount_minor`	`integer`	Ոչ	—
`renewal_currency`	`string`	Ոչ	—
`created_at`	`string`	Այո	—
`decided_at`	`string`	Ոչ	—
`failure_reason`	`string`	Ոչ	Why a `failed` transfer could not complete. Empty otherwise.

Այս վերջնակետի կողմից վերադարձվող սխալները

401 · 403 · 404 · 409 · 429

DELETE /v1/sites/{siteId}/transfer