platform-transfers
POST /v1/platform-transfers
Book a platform transfer (nothing is charged yet).
Πισtoποίηση
Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα billing.view· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.
Πού μπαίνει το αναγνωριστικό του οργανισμού σας
Αυτό το endpoint δέχεται το πεδίο org_id στο σώμα JSON.
Το αναγνωριστικό του οργανισμού σας βρίσκεται στην οθόνη των κλειδιών API στον πίνακα ελέγχου σας, δίπλα στο ίδιο το κλειδί. Είναι το ίδιο αναγνωριστικό σε κάθε κλήση που πραγματοποιείτε.
Δοκιμάστε το
Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.
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 στον πίνακα ελέγχου σας συμπληρώνει το πραγματικό αναγνωριστικό του οργανισμού σας και το δικό σας κλειδί, και εκτελεί το αίτημα στο ζωντανό API, ώστε να μπορείτε να δείτε την πραγματική απόκριση. Ανοίξτε αυτό το τελικό σημείο στην κονσόλα 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`.
Σώμα αίτησης
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
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 | Όχι | — |
Απάντηση
| Όνομα | Τύpος | Υποχρεωτικό | Τι είναι |
|---|---|---|---|
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