Pagpapatotoo
Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.
Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.
Subukan ito
Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.
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> }'Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API
Mga Detalye
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.
Mga Parameter
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
Idempotency-Key (header) | string | Hindi | Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack. |
Katawan ng kahilingan
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
quantity | integer | Oo | The pack size to buy. Must be one offered by `GET /v1/seo/quota`. |
Tugon
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
daily_allowance | integer | Oo | Lookups included per day. `-1` means unlimited. |
used_today | integer | Oo | Plan-funded lookups run since midnight UTC. |
plan_remaining | integer | Hindi | — |
top_up_remaining | integer | Hindi | Purchased lookups still unspent. These do not expire. |
remaining | integer | Oo | — |
is_unlimited | boolean | Hindi | — |
can_look_up | boolean | Oo | 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 | Hindi | — |
packs | object[] | Oo | Packs of extra lookups available to buy. |
Mga error na maibabalik ng endpoint na ito
401 · 403 · 422