seo

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

Buy extra domain lookups.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API) كرمز حامل (bearer token). لا يحدد نقطة النهاية هذه إذنًا محددًا في المواصفات، لذا امنح مفتاحك الحد الأدنى الذي محتاجه وتحقق من الاستجابة بدلاً من الافتراض.

لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.

جربه الآن

استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.

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

التفاصيل

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