seo

POST `/v1/seo/quota/top-up`

Buy extra domain lookups.

Autentifikacija

Pošaljite API ključ kao bearer token. Ova krajnja točka ne navodi određenu dozvolu u specifikaciji, stoga dajte svom ključu najmanje što mu je potrebno i provjerite odgovor umjesto da pretpostavljate.

Ova krajnja točka ne prihvaća ID organizacije. Vaš ključ već identificira organizaciju kojoj pripada, a odgovor je ograničen na nju.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

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> }'

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

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

Naziv	Vrsta	Obavezno	Što je to
`Idempotency-Key (header)`	`string`	Ne	Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack.

Tijelo zahtjeva

Naziv	Vrsta	Obavezno	Što je to
`quantity`	`integer`	Da	The pack size to buy. Must be one offered by `GET /v1/seo/quota`.

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`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`	Ne	—
`top_up_remaining`	`integer`	Ne	Purchased lookups still unspent. These do not expire.
`remaining`	`integer`	Da	—
`is_unlimited`	`boolean`	Ne	—
`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`	Ne	—
`packs`	`object[]`	Da	Packs of extra lookups available to buy.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 422

POST /v1/seo/quota/top-up