partner
GET /v1/partner/customers/{externalId}/hosting-slots
How many sites each of your customer's hosting plans can still take.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу partner.domains; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X GET https://api.zinndigital.com/v1/partner/customers/{externalId}/hosting-slots \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
One row per product line the customer holds a site-hosting plan on. max_sites, used_sites and free_sites come from the SAME function that refuses a site create when a plan is full, so a row with free_sites > 0 is one createPartnerSiteMove will accept. Every site that is not yet deleted counts as used — including one that failed to build and one being deleted. A customer on a free TRIAL has a row too (kind: trial): its subscription_id is the trial's id, which createPartnerSiteMove accepts as subscription_id. replaceable_sites lists the sites a move may import into instead of taking a free slot, each with replaceable_reason: temporary_host (still on a temporary address of ours) or empty_starter (the site the plan or trial was delivered with, on the customer's own domain, never imported into — the move re-checks that it is still empty and refuses with replace_site_not_empty if it is not). available_sites is free_sites plus the replaceable ones: the number to decide on whether a move can be offered. A plan that cannot take an imported site is listed with importable: false so you can say why. 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… |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
slots | PartnerHostingSlot[] | Да | — |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 429