platform-transfers
POST /v1/platform-transfers
Book a platform transfer (nothing is charged yet).
ማረጋገጫ
የAPI ቁልፉን እንደ bearer token ይላኩ። ቁልፉ የbilling.view ፈቃድ ሊኖረው ይገባል፤ ይህ ፈቃድ የሌለው ቁልፍ በ404 ሳይሆን በ403 ውድቅ ይደረጋል።
የድርጅትዎ መታወቂያ የሚገባበት ቦታ
ይህ ማቆሚያ ነጥብ (endpoint) org_idን በJSON አካል ውስጥ እንደ ሜዳ ይወስዳል።
የድርጅትዎ መለያ ቁጥር (ID) በዳሽቦርድዎ ላይ በሚገኙት የኤፒአይ ቁልፎች (API keys) ማያ ገጽ ላይ ከቁልፉ አጠገብ ይገኛል። በሚያደርጉት እያንዳንዱ ጥያቄ ላይ የሚጠቀሙበት መለያ ቁጥር አንድ አይነት ነው።
ሞክሩት
በቅንፍ ውስጥ ያለውን ማንኛውንም ነገር በራስዎ እሴቶች ይተኩ፣ እና ቁልፍ ቦታ ያዢውን ከዳሽቦርድዎ በመጣ ቁልፍ ይተኩ።
curl -X POST https://api.zinndigital.com/v1/platform-transfers \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "source_platform": <string>, "target_platform": <string>, "source_url": <string>, "entity_count": <integer> }'ገብተዋል? የመቆጣጠሪያ ማዕከልዎ ውስጥ ያለው የኤፒአይ ኮንሶል ትክክለኛውን የድርጅት መታወቂያዎን እና የራስዎን ቁልፍ ይሞላል፣ እና ትክክለኛውን ምላሽ ማየት እንዲችሉ ጥያቄውን በቀጥታ ከሚሰራው ኤፒአይ ጋር ያካሂደዋል። ይህን ኤንድፖይንት በAPI ኮንሶል ውስጥ ይክፈቱ
ዝርዝሮች
Creates the request in `draft`. **No money moves here** — call `payPlatformTransfer` to charge it. The row is written before the charge on purpose: a declined card then leaves a visible `payment_failed` transfer rather than a charge for a job nobody can see. Requires `billing.view`.
የጥያቄ አካል
| ስም | ዓይነት | የሚያስፈልግ | ምንነቱ |
|---|---|---|---|
source_platform | string | አዎ | — |
target_platform | string | አዎ | — |
source_url | string | አዎ | — |
entity_count | integer | አዎ | — |
target_site_id | object | አይ | Where it lands. May be omitted — a customer often buys the transfer before the destination site exists, which is the point of an on-ramp. |
customer_note | string | አይ | — |
org_id | object | አይ | — |
ምላሽ
| ስም | ዓይነት | የሚያስፈልግ | ምንነቱ |
|---|---|---|---|
id | Uuid | አዎ | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
source_platform | string | አዎ | — |
source_platform_name | string | አይ | — |
target_platform | string | አዎ | — |
target_platform_name | string | አይ | — |
source_url | string | አዎ | — |
target_site_id | object | አይ | — |
tier_code | string | አዎ | — |
tier_name | string | አይ | — |
entity_count_estimate | integer | አይ | — |
status | PlatformTransferStatus | አዎ | — |
status_label | string | አይ | — |
price_amount_minor | integer | አዎ | — |
price_currency | string | አዎ | — |
redirects_mapped | boolean | አይ | — |
redirect_count | integer | አይ | — |
canonicals_verified | boolean | አይ | — |
sitemap_submitted | boolean | አይ | — |
structured_data_preserved | boolean | አይ | — |
seo_checks_complete | boolean | አይ | — |
customer_note | string | አይ | — |
sla_due_at | object | አይ | — |
created_at | string | አዎ | — |
completed_at | object | አይ | — |
events | PlatformTransferEvent[] | አይ | The customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here. |
ይህ ማብቂያ ሊመልሳቸው የሚችሉ ስህተቶች
401 · 403 · 404 · 422 · 429