Autentikasi
Kirimkan kunci API sebagai token bearer. Titik akhir ini tidak menyatakan izin tertentu dalam spesifikasi, jadi berikan kunci Anda izin minimum yang diperlukan dan periksa responsnya alih-alih berasumsi.
Endpoint ini tidak memerlukan id organisasi. Kunci Anda telah mengidentifikasi organisasi tempatnya berafiliasi, dan respons akan dibatasi untuk organisasi tersebut.
Coba
Ganti apa pun di dalam tanda kurung sudut dengan nilai Anda sendiri, dan placeholder kunci dengan kunci dari dasbor Anda.
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> }'Sudah masuk? Konsol API di dasbor Anda akan mengisi ID organisasi asli dan kunci Anda sendiri, serta menjalankan permintaan terhadap API langsung sehingga Anda dapat melihat respons aktualnya. Buka titik akhir ini di konsol API
Detail
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.
Parameter
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
Idempotency-Key (header) | string | Tidak | Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack. |
Isi permintaan
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
quantity | integer | Ya | The pack size to buy. Must be one offered by `GET /v1/seo/quota`. |
Tanggapan
| Nama | Jenis | Wajib | Tentang apa ini |
|---|---|---|---|
daily_allowance | integer | Ya | Lookups included per day. `-1` means unlimited. |
used_today | integer | Ya | Plan-funded lookups run since midnight UTC. |
plan_remaining | integer | Tidak | — |
top_up_remaining | integer | Tidak | Purchased lookups still unspent. These do not expire. |
remaining | integer | Ya | — |
is_unlimited | boolean | Tidak | — |
can_look_up | boolean | Ya | 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 | Tidak | — |
packs | object[] | Ya | Packs of extra lookups available to buy. |
Kesalahan yang dapat dikembalikan oleh titik akhir ini
401 · 403 · 422