reseller
GET /v1/reseller/services
Everything you have provisioned for your clients.
Autenticazione
Invia una chiave API come token di tipo bearer. La chiave deve disporre dell'autorizzazione reseller.view; una chiave sprovvista di tale autorizzazione viene rifiutata con 403 anziché 404.
L'ID della tua organizzazione va qui
Questo endpoint accetta org_id come parametro di query. Omettilo e la chiamata coprirà l'intero sottoalbero del tuo tenant; invialo per limitare la chiamata a una singola organizzazione.
L'identificativo della tua organizzazione si trova nella schermata delle chiavi API nella tua dashboard, accanto alla chiave stessa. È lo stesso identificativo in ogni chiamata che effettui.
Provalo
Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.
curl -X GET https://api.zinndigital.com/v1/reseller/services \
-H "Authorization: Bearer zdk_live_…"Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API
Dettagli
One row per site across your client subtree — the client organization it belongs to, its plan, its lifecycle status, its disk and bandwidth usage, and the price *you* charge for it. This is the endpoint a billing panel polls to keep its own records in step with ours, and it is the answer to "what have I actually sold". Cursor-paginated. Requires `reseller.view`. Sites in your OWN organization are excluded: this surface is about what you resell, and mixing your own estate into it would make a billing panel invoice you for your own sites.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
cursor (query) | string | No | Opaque cursor from a previous page's `page.next_cursor`. |
limit (query) | integer | No | Maximum items to return (page size). |
org_id (query) | Uuid | No | Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r… |
client_org_id (query) | Uuid | No | Narrow to one client organization. |
status (query) | SiteStatus | No | Narrow to one site status. |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
data | ResellerService[] | Sì | — |
page | PageMeta | Sì | — |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429