partner

GET `/v1/partner/customers/{externalId}/domain-orders/{orderId}`

Read one of your customer's domain orders, and each domain it became.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу partner.domains; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X GET https://api.zinndigital.com/v1/partner/customers/{externalId}/domain-orders/{orderId} \
  -H "Authorization: Bearer zdk_live_…"

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

The authoritative state of an order you placed — its status, and for every line the domain's own status, nameservers and expiry once provisioning has created it (domain is null until then). An order of another customer, of another partner, or one the customer placed themselves is a 404. There is no pay_url here: the link is shown once, when the order is placed. Requires partner.domains.

Параметри

Назив	Тип	Обавезно	Шта је ово
`externalId (path)`	`string`	Да	YOUR id for that customer — whatever your own system calls them. It is what makes linking idempotent, and it is scoped to your partner programme: another partner's id is a `404`…
`orderId (path)`	`string`	Да	—

Одговор

Назив	Тип	Обавезно	Шта је ово
`order_id`	`string`	Да	—
`human_ref`	`string`	Да	The reference the payment page returns to you as `?order=`.
`pay_url`	`string`	Не	Only in the response that placed (or replayed) the order: the hosted page the customer pays on. It carries a secret that is stored nowhere — treat it as one.
`pay_expires_at`	`string`	Не	—
`org_id`	`string`	Да	—
`status`	`string`	Да	`pending_payment` for a freshly placed order; afterwards the order's lifecycle (`paid`, `fulfilling`, `completed`, `partially_fulfilled`, `canceled`, …).
`currency`	`string`	Да	—
`subtotal_minor`	`integer`	Да	—
`tax_minor`	`integer`	Да	—
`total_minor`	`integer`	Да	—
`lines`	`PartnerOrderLine[]`	Да	—

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 429

GET /v1/partner/customers/{externalId}/domain-orders/{orderId}