reseller

PUT `/v1/reseller/edge-policy`

Turn CDN or DNS networks on and off for your clients.

المصادقة

أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن reseller.manage؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.

حيث يتم إدخال معرف مؤسستك

تأخذ نقطة النهاية هذه org_id كمعلمة استعلام. اتركه فارغاً ليغطي الاستدعاء شجرة مستأجريك بالكامل، أو أرسله لتضييق نطاق الاستدعاء ليشمل منظمة واحدة.

معرف مؤسستك موجود على شاشة مفاتيح واجهة برمجة التطبيقات (API) في لوحة تحكمك، بجوار المفتاح نفسه. وهو نفس المعرف في كل طلب تجريه.

جربه الآن

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

curl -X PUT https://api.zinndigital.com/v1/reseller/edge-policy \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "disabled": <ResellerEdgeVendorRef[]> }'

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

التفاصيل

Send the **complete** set of networks you are turning off; anything absent is on. This is a placement rule, not a display preference: a network you turn off disappears from your clients' site-creation picker, is refused if they name it directly, and is not used when Zinn® places a new site. **Sites already running are never moved** — a live site keeps the network it is on, so nothing goes down when you change what you offer. You can only narrow what your pool serves, never add a network, and turning off every network in a category is refused because your clients could then create no sites at all. Requires `reseller.manage`.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`org_id (query)`	`Uuid`	لا	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r…

جسم الطلب

الاسم	النوع	مطلوب	ما هو هذا
`disabled`	`ResellerEdgeVendorRef[]`	نعم	The complete set of networks to turn off. Anything absent is turned on, so send the full state rather than a change — two screens open at once cannot then leave a switch beh…

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`data`	`ResellerEdgeVendor[]`	نعم	Every CDN and DNS network your clients could be placed on, in category then alphabetical order. The list reflects your pool: your own connected accounts if you have any, oth…

الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه

401 · 403 · 404 · 422 · 429

PUT /v1/reseller/edge-policy