reseller
GET /v1/reseller/vendor-policy
Whose SEO data accounts your clients' checks run on.
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/vendor-policy \
-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
Your choice of running client SEO and indexing data on your **own** Majestic / DataForSEO keys — which costs you nothing with us — or on Zinn®'s accounts as a metered monthly add-on. `client_overrides` lists every one of your clients with the cap you have set for them; a client you have never touched appears with `daily_lookup_cap: null`, meaning they get whatever their plan grants. `monthly_pool_micros` is read-only: it is a commercial term of your programme, and `null` means no pool has been set at all — which is **unbounded**, not zero. Requires `reseller.view`.
Parametri
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
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… |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
seo_data_mode | string<own_keys, platform_pool> | Sì | `own_keys` runs client SEO and indexing lookups on credentials you connect yourself and is free of charge from us. `platform_pool` runs them on Zinn®'s accounts against your mon… |
monthly_pool_micros | integer | Sì | Your monthly allowance of Zinn-funded vendor spend, in USD micros (1,000,000 = $1). Read-only — it is a commercial term of your programme. `null` means **no pool has been set**,… |
alert_at_bps | integer | Sì | Basis points of the pool at which you are warned. 8000 = 80%. |
client_overrides | ResellerClientVendorRow[] | Sì | Every one of your clients, including those you have never capped — a client with no cap set appears with `daily_lookup_cap: null`. |
Errori che questo endpoint può restituire
401 · 403 · 404 · 429