domains
DELETE /v1/domains/{domainId}/email-routing/enabled
Turn inbound email routing off for a domain.
Pagpapatotoo
Magpadala ng API key bilang isang bearer token. Kailangang taglayin ng key ang pahintulot na domains.dns.manage; ang key na wala nito ay tatanggihan gamit ang 403, hindi 404.
Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.
Subukan ito
Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.
curl -X DELETE https://api.zinndigital.com/v1/domains/{domainId}/email-routing/enabled \
-H "Authorization: Bearer zdk_live_…"Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API
Mga Detalye
Ungated, deliberately: turning routing off gives the customer their mail back rather than taking it, and gating an exit is how a customer gets stuck. Requires `domains.dns.manage`.
Mga Parameter
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
domainId (path) | Uuid | Oo | The domain's id. |
Tugon
| Pangalan | Uri | Kailangan | Ano ito |
|---|---|---|---|
domain_id | Uuid | Oo | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
fqdn | string | Oo | — |
supported | boolean | Oo | — |
enabled | boolean | Oo | — |
status | string | Oo | The provider's own word for the zone's state. Displayed, never branched on. |
dns_ready | boolean | Oo | Whether the provider reports the required DNS actually live. Distinct from `enabled` — a zone can be switched on with its `MX` not yet resolving. |
plan | DomainEmailRoutingDnsRecord[] | Oo | — |
rules | DomainEmailRoutingRule[] | Oo | — |
catch_all | DomainEmailRoutingRule | Oo | — |
addresses | DomainEmailRoutingAddress[] | Oo | — |
addresses_readable | boolean | Oo | `false` when the credential could not list destination addresses — a scope a customer's own token may legitimately lack. Separate from an empty `addresses` list, because an empt… |
rules_readable | boolean | Oo | `false` when the credential could not list the forwarding rules. `Zone → Email Routing Rules` is a **separate** Cloudflare permission from the one that reads the zone's routing… |
status_readable | boolean | Oo | `false` when the credential could not read the zone's routing **settings** — the half that supplies `enabled`, `status`, `dns_ready` and `plan`. On Cloudflare this is a differen… |
impact | DomainEmailRoutingImpact | Oo | What turning routing on would replace, measured against the zone's live records. |
Mga error na maibabalik ng endpoint na ito
401 · 403 · 404 · 422 · 429 · 503