Doğrulama
API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
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> }'Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
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.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
Idempotency-Key (header) | string | Xeyr | Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack. |
Sorğu gövdəsi
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
quantity | integer | Bəli | The pack size to buy. Must be one offered by `GET /v1/seo/quota`. |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
daily_allowance | integer | Bəli | Lookups included per day. `-1` means unlimited. |
used_today | integer | Bəli | Plan-funded lookups run since midnight UTC. |
plan_remaining | integer | Xeyr | — |
top_up_remaining | integer | Xeyr | Purchased lookups still unspent. These do not expire. |
remaining | integer | Bəli | — |
is_unlimited | boolean | Xeyr | — |
can_look_up | boolean | Bəli | 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 | Xeyr | — |
packs | object[] | Bəli | Packs of extra lookups available to buy. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 422