platform-transfers
POST /v1/platform-transfers
Book a platform transfer (nothing is charged yet).
Ìfàṣẹ́pọ̀
Fi bọ́ọ̀lù (bearer token) ranṣẹ gẹ́gẹ́ bí kọ́kọ́rọ́ API. Kọ́kọ́rọ́ náà gbọ́dọ̀ ní ìyọ̀ǹda billing.view; a ó kọ̀ ọ́ silẹ pẹlu 403, kii ṣe 404, ti kọ́kọ́rọ́ náà kò bá ní i.
Ibùdó àmì ìdánimọ̀ ilé-iṣẹ́ rẹ sí
Ibi-iwọle yii n gba org_id gẹgẹ bi aaye ninu ara JSON naa.
Id àjọ rẹ wa lórí ojú-ìwákòòkò àwọn bọ́tìnnì API nínú daṣibọọdú rẹ, lẹ́gbẹ̀ẹ́ bọ́tìnnì náà gan-an. Ó jẹ́ ìd kan náà nínú gbogbo ìpè tí o bá ṣe.
Gbiyanju rẹ
Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.
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> }'Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API
Àwọn kúlẹ̀kúlẹ̀
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`.
Akoonu ibeere naa
| Orúkọ | Iru | Tí a nílò | Kini o jẹ |
|---|---|---|---|
source_platform | string | Bẹẹni | — |
target_platform | string | Bẹẹni | — |
source_url | string | Bẹẹni | — |
entity_count | integer | Bẹẹni | — |
target_site_id | object | Bẹẹkọ | 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 | Bẹẹkọ | — |
org_id | object | Bẹẹkọ | — |
Idahun
| Orúkọ | Iru | Tí a nílò | Kini o jẹ |
|---|---|---|---|
id | Uuid | Bẹẹni | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
source_platform | string | Bẹẹni | — |
source_platform_name | string | Bẹẹkọ | — |
target_platform | string | Bẹẹni | — |
target_platform_name | string | Bẹẹkọ | — |
source_url | string | Bẹẹni | — |
target_site_id | object | Bẹẹkọ | — |
tier_code | string | Bẹẹni | — |
tier_name | string | Bẹẹkọ | — |
entity_count_estimate | integer | Bẹẹkọ | — |
status | PlatformTransferStatus | Bẹẹni | — |
status_label | string | Bẹẹkọ | — |
price_amount_minor | integer | Bẹẹni | — |
price_currency | string | Bẹẹni | — |
redirects_mapped | boolean | Bẹẹkọ | — |
redirect_count | integer | Bẹẹkọ | — |
canonicals_verified | boolean | Bẹẹkọ | — |
sitemap_submitted | boolean | Bẹẹkọ | — |
structured_data_preserved | boolean | Bẹẹkọ | — |
seo_checks_complete | boolean | Bẹẹkọ | — |
customer_note | string | Bẹẹkọ | — |
sla_due_at | object | Bẹẹkọ | — |
created_at | string | Bẹẹni | — |
completed_at | object | Bẹẹkọ | — |
events | PlatformTransferEvent[] | Bẹẹkọ | The customer-visible trail only. Staff notes name vendors and what a job cost us, and never appear here. |
Awọn aṣiṣe ti ibudo ipari yii le da pada
401 · 403 · 404 · 422 · 429