hosting

POST `/v1/sites/{siteId}/transfer/preview`

Check whether a site could be transferred to another organization.

প্রমাণীকরণ

একটি বিয়ারার টোকেন হিসেবে একটি এপিআই কি পাঠান। কি-টির অবশ্যই sites.view অনুমতি থাকতে হবে; এটি ছাড়া কোনো কি ৪০৪ নয়, বরং ৪০৩ ত্রুটি দিয়ে প্রত্যাখ্যাত হবে।

এই এন্ডপয়েন্টটি কোনো অর্গানাইজেশন আইডি নেয় না। আপনার কীটি ইতিমধ্যে এটি যে অর্গানাইজেশনের অন্তর্গত তা শনাক্ত করে এবং প্রতিক্রিয়াটি সেই অনুযায়ী নির্ধারিত হয়।

চেষ্টা করুন

কোণ বন্ধনীতে থাকা যেকোনো কিছু আপনার নিজস্ব মান দিয়ে এবং কী প্লেসহোল্ডারটি আপনার ড্যাশবোর্ডের একটি কী দিয়ে প্রতিস্থাপন করুন।

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/transfer/preview \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "target_org_id": <Uuid> }'

লগ ইন করা আছে? আপনার ড্যাশবোর্ডের এপিআই কনসোল আপনার আসল অর্গানাইজেশন আইডি এবং আপনার নিজের কি পূরণ করে দেয়, এবং লাইভ এপিআই-এর বিপরীতে অনুরোধটি চালায় যাতে আপনি প্রকৃত প্রতিক্রিয়া দেখতে পান। এই এন্ডপয়েন্টটি এপিআই কনসোলে খুলুন

বিবরণ

Answers *"would this go through, and what would it take with it"* without writing anything. The sender's form calls this before it offers, so arrears and structural problems read as a checklist rather than as a failure after the fact. ⛔ **`POST` for a read**, deliberately: the proposal has a body (a target organization and a domain choice), and putting a UUID in a query string would leave the receiving account's id in access logs and `Referer` headers. ⛔ **The receiving account's arrears are NOT itemised to the sender.** When the target organization is what blocks the transfer, `details` carries a single `target_account` entry saying only that the receiving account has an outstanding balance its owner must settle. Itemising it would make this endpoint a way to read any organization's financial position by offering it a site. The receiver sees every number on their own accept screen, where it is their own data. Requires `sites.view` **and** `sites.transfer`. `404` for a site that is not theirs.

পরামিতি

নাম	ধরন	আবশ্যক	এটি কী
`siteId (path)`	`Uuid`	হ্যাঁ	Site ID (UUIDv7).

অনুরোধের বডি

নাম	ধরন	আবশ্যক	এটি কী
`target_org_id`	`Uuid`	হ্যাঁ	The receiving organization's id, which its owner gives to the sender. ⛔ An organization id rather than an email address, and that is a privacy decision. Resolving a recipien…
`include_domain`	`boolean`	না	Whether the domain registration, its DNS zone and records, and its mail travel with the site. `false` moves the site alone and the receiver points a domain of their own at it.

প্রতিক্রিয়া

নাম	ধরন	আবশ্যক	এটি কী
`allowed`	`boolean`	হ্যাঁ	Whether the transfer would be permitted right now.
`message`	`string`	হ্যাঁ	The refusal in words, composed by the engine for API and staff-console readers. Empty when `allowed`. The dashboard renders its own localised sentences from `details[].field` an…
`details`	`ErrorDetail[]`	হ্যাঁ	One entry per reason, machine-readable. `field` is the blocker code (`unpaid_invoices`, `dunning_active`, `page_view_overage`, `bandwidth_overage`, `wholesale_statement`, `faile…
`include_domain`	`boolean`	হ্যাঁ	—
`domain_names`	`string[]`	হ্যাঁ	The domains that would change hands. Read from the registrations we actually hold — a site on a domain registered elsewhere lists none, rather than naming a registration we cann…
`term_ends_at`	`string`	না	When the inherited paid term runs out. The receiver pays nothing until then.
`renewal_amount_minor`	`integer`	না	What it renews at, in minor units of `renewal_currency`.
`renewal_currency`	`string`	না	The subscription's currency, which does not change on transfer. A locked price is already currency-locked, and converting it would silently re-price a paid term at a rate no…
`moving_tables`	`integer`	হ্যাঁ	How many of the platform's site-attached record types would move.
`staying_tables`	`integer`	হ্যাঁ	How many would stay with the sender — traffic and usage evidence, tickets, abuse history, paid add-ons.

এই এন্ডপয়েন্ট থেকে যেসব ত্রুটি আসতে পারে

401 · 403 · 404 · 429

POST /v1/sites/{siteId}/transfer/preview