domains

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

Change a forwarding rule.

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението 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, за да можете да видите действителния отговор. Отворете този крайpoint в 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…

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 422 · 429 · 503

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