Autentificare
Trimiteți o cheie API ca token de tip bearer. Acest punct final nu specifică o permisiune anume în specificație, așa că acordați cheii cele mai puține drepturi necesare și verificați răspunsul în loc să faceți presupuneri.
Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.
Încearcă
Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.
curl -X POST https://api.zinndigital.com/v1/seo/quota/top-up \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "quantity": <integer> }'Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API
Detalii
Buys a pack of additional lookups, paid from the account credit balance. Purchased lookups do not expire and are spent only once the daily plan allowance is used up. Idempotent on the `Idempotency-Key` header: repeating a request with the same key returns the same purchase rather than buying a second pack. `422` when the pack size is not sold or the credit balance does not cover it — in which case nothing is charged at all.
Parametri
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
Idempotency-Key (header) | string | Nu | Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack. |
Corp cerere
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
quantity | integer | Da | The pack size to buy. Must be one offered by `GET /v1/seo/quota`. |
Răspuns
| Nume | Tip | Obligatoriu | Ce este |
|---|---|---|---|
daily_allowance | integer | Da | Lookups included per day. `-1` means unlimited. |
used_today | integer | Da | Plan-funded lookups run since midnight UTC. |
plan_remaining | integer | Nu | — |
top_up_remaining | integer | Nu | Purchased lookups still unspent. These do not expire. |
remaining | integer | Da | — |
is_unlimited | boolean | Nu | — |
can_look_up | boolean | Da | Whether a lookup would be permitted right now. **Not** the same as `remaining > 0`: a suspended or unpaid account may have lookups left and still be refused. |
in_good_standing | boolean | Nu | — |
packs | object[] | Da | Packs of extra lookups available to buy. |
Erori pe care le poate returna acest punct final
401 · 403 · 422