seo

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

Buy extra domain lookups.

אימות

שלח מפתח API כטוקן Bearer. נקודת קצה זו אינה מציינת הרשאת ספציפית במפרט, לכן הקצה למפתח שלך את המינימום הנדרש ובדוק את התגובה במקום להניח הנחות.

נקודת קצה זו אינה דורשת מזהה ארגון. המפתח שלך כבר מזהה את הארגון שאליו הוא שייך, והתגובה מוגבלת אליו בלבד.

נסה זאת

החלף כל דבר בסוגריים זוויתיים בערכים משלך, ואת מציין מיקום המפתח במפתח מלוח הבקרה שלך.

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

מחובר? קונסולת ה-API בלוח הבקרה שלך מזינה את מזהה הארגון האמיתי שלך ואת המפתח שלך, ומריצה את הבקשה מול ה-API הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-API

פרטים

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.

פרמטרים

שם	סוג	נדרש	מה זה
`Idempotency-Key (header)`	`string`	לא	Caller-supplied replay key. Strongly recommended: without one, a retried request buys a second pack.

גוף הבקשה

שם	סוג	נדרש	מה זה
`quantity`	`integer`	כן	The pack size to buy. Must be one offered by `GET /v1/seo/quota`.

תשובה

שם	סוג	נדרש	מה זה
`daily_allowance`	`integer`	כן	Lookups included per day. `-1` means unlimited.
`used_today`	`integer`	כן	Plan-funded lookups run since midnight UTC.
`plan_remaining`	`integer`	לא	—
`top_up_remaining`	`integer`	לא	Purchased lookups still unspent. These do not expire.
`remaining`	`integer`	כן	—
`is_unlimited`	`boolean`	לא	—
`can_look_up`	`boolean`	כן	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`	לא	—
`packs`	`object[]`	כן	Packs of extra lookups available to buy.

שגיאות שנקודה קצה זו עשויה להחזיר

401 · 403 · 422

POST /v1/seo/quota/top-up