partner

GET /v1/partner/customers/{externalId}/hosting-slots

How many sites each of your customer's hosting plans can still take.

Све partner крајње тачке

Сва документација за програмере →

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

Пошаљите 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…

Одговор

НазивТипОбавезноШта је ово
slotsPartnerHostingSlot[]Да—

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

401 · 403 · 404 · 429