domains

PUT `/v1/domains/{domainId}/email-routing/rules/{ruleId}`

Change a forwarding rule.

אימות

שלחו מפתח API כאסימון נושא (bearer token). על המפתח לכלול את הרשאה domains.dns.manage; מפתח שאינו כולל אותה יידחה בסטטוס 403, ולא 404.

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

נסה זאת

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

curl -X PUT https://api.zinndigital.com/v1/domains/{domainId}/email-routing/rules/{ruleId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "matcher": <string>, "destinations": <string[]> }'

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

פרטים

Requires `domains.dns.manage`. The catch-all is a separate resource at the provider and cannot be changed through this path — use `PUT .../email-routing/catch-all`.

פרמטרים

שם	סוג	נדרש	מה זה
`domainId (path)`	`Uuid`	כן	The domain's id.
`ruleId (path)`	`string`	כן	The provider's own id for the routing rule.

גוף הבקשה

שם	סוג	נדרש	מה זה
`matcher`	`string`	כן	—
`destinations`	`string[]`	כן	—
`action`	`EmailRoutingAction`	לא	`drop` is a chosen behaviour — it is how a catch-all silently discards spam — and is never inferred from an empty destination list.
`name`	`string`	לא	—
`enabled`	`boolean`	לא	—

תשובה

שם	סוג	נדרש	מה זה
`rule_id`	`string`	כן	—
`matcher`	`string`	כן	The address this rule applies to. Empty for the catch-all.
`destinations`	`string[]`	כן	—
`action`	`EmailRoutingAction`	כן	`drop` is a chosen behaviour — it is how a catch-all silently discards spam — and is never inferred from an empty destination list.
`name`	`string`	כן	—
`enabled`	`boolean`	כן	—
`catch_all`	`boolean`	כן	—
`unsupported`	`boolean`	כן	`true` when the provider's rule uses a shape this API cannot express — a Worker target, say. Such a rule is shown read-only rather than hidden: hiding it would make this screen…

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

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/domains/{domainId}/email-routing/rules/{ruleId}