hosting

PUT `/v1/sites/{siteId}/wordpress/settings`

Set one WordPress option on a site.

المصادقة

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

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

جربه الآن

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

curl -X PUT https://api.zinndigital.com/v1/sites/{siteId}/wordpress/settings \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "option": <string>, "value": <string> }'

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

التفاصيل

Writes a single option and returns the whole option map. The option is named in the body rather than the path: unlike a plugin slug it is not a resource, and this platform writes one option per call, so one write endpoint is the honest shape. ⛔ An option the vendor does not publish is refused 422 rather than written blindly — writing an unknown key into a live WordPress is how a site gets a setting nothing can read back and nothing can undo. 404 for a site with no vendor hosting package. Requires sites.view and sites.panel_access.

المعلمات

الاسم	النوع	مطلوب	ما هو هذا
`siteId (path)`	`Uuid`	نعم	Site ID (UUIDv7).

جسم الطلب

الاسم	النوع	مطلوب	ما هو هذا
`option`	`string`	نعم	The option name, as `getSiteWordPressSettings` reports it. An option the vendor does not publish is refused.
`value`	`string`	نعم	The new value. May be empty — clearing a tagline is a legitimate edit, not a mistake to guess at.

الاستجابة

الاسم	النوع	مطلوب	ما هو هذا
`data`	`object`	نعم	The options, keyed by name.

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

401 · 403 · 404 · 409 · 422 · 429 · 503

PUT /v1/sites/{siteId}/wordpress/settings