platform-transfers
POST /v1/platform-transfers
Book a platform transfer (nothing is charged yet).
Xaqiijinta aqoonsiga
U dir furaha API ah calaamad dusha ah (bearer token). Furaha waa inuu wataa ruqadda billing.view; furaha aan wadan waxaa loo diidayaa 403, ee ma aha 404.
Meesha aqoonsiga ururkaagu galayo
Boggan waxaa uu qaataa org_id oo ah goob ku jirta JSON body.
Aqoonsiga ururkaagu wuxuu ku yaallaa shaashada furayaasha API ee dashboard-kaaga, oo ku xiga furaha laftiisa. Waa isku aqoonsi wicitaan kasta oo aad sameyso.
Isku day
Ku beddel wax kasta oo ku dhex jira qeebaha xaglaha ah qiimayaashaada, sidoo kalena haystaaha furaha ku beddel fure ka dhex muuqda dashboordigaaga.
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> }'Ma sign-garaysay? Qalabka API ee ku jira dashboard-kaagu wuxuu buuxiyaa aqoonsigaaga ururka ee dhabta ah iyo furahaaga gaarka ah, wuxuuna ku shaqeysiiyaa codsiga API-ga nool si aad u aragto jawaabta dhabta ah. Kani ka fur barta kontoroolka ee API
Faahfaahin
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`.
Codsiga jidhkiisa
| Magaca | Nooc | Loo baahan yahay | Maxay tahay |
|---|---|---|---|
source_platform | string | Haa | — |
target_platform | string | Haa | — |
source_url | string | Haa | — |
entity_count | integer | Haa | — |
target_site_id | object | Maya | 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 | Maya | — |
org_id | object | Maya | — |
Jawaab
| Magaca | Nooc | Loo baahan yahay | Maxay tahay |
|---|---|---|---|
id | Uuid | Haa | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
source_platform | string | Haa | — |
source_platform_name | string | Maya | — |
target_platform | string | Haa | — |
target_platform_name | string | Maya | — |
source_url | string | Haa | — |
target_site_id | object | Maya | — |
tier_code | string | Haa | — |
tier_name | string | Maya | — |
entity_count_estimate | integer | Maya | — |
status | PlatformTransferStatus | Haa | — |
status_label | string | Maya | — |
price_amount_minor | integer | Haa | — |
price_currency | string | Haa | — |
redirects_mapped | boolean | Maya | — |
redirect_count | integer | Maya | — |
canonicals_verified | boolean | Maya | — |
sitemap_submitted | boolean | Maya | — |
structured_data_preserved | boolean | Maya | — |
seo_checks_complete | boolean | Maya | — |
customer_note | string | Maya | — |
sla_due_at | object | Maya | — |
created_at | string | Haa | — |
completed_at | object | Maya | — |
events | PlatformTransferEvent[] | Maya | The customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here. |
Cilladaha ay bartaani soo celin karto
401 · 403 · 404 · 422 · 429