mail

GET `/v1/mail/routing/{fqdn}`

How one domain's mail is routed.

אימות

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

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

נסה זאת

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

curl -X GET https://api.zinndigital.com/v1/mail/routing/{fqdn} \
  -H "Authorization: Bearer zdk_live_…"

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

פרטים

Requires mail.view.

פרמטרים

שם	סוג	נדרש	מה זה
`fqdn (path)`	`string`	כן	The hostname whose mail routing is being read or changed.

תשובה

שם	סוג	נדרש	מה זה
`fqdn`	`string`	כן	The domain this routing is for.
`mechanism`	`string<zinn_mailbox, zinn_forward, cloudflare_routing, external, none>`	כן	Which mechanism serves this domain's inbound mail. `zinn_mailbox` stores it; `zinn_forward` and `cloudflare_routing` pass it on and store nothing; `external` means the customer's…
`mechanism_label`	`string`	כן	Why this mechanism was chosen, in a sentence a person can act on.
`forwards`	`boolean`	כן	Whether mail is passed on rather than stored.
`stores`	`boolean`	כן	Whether this domain has real mailboxes on our relay.
`status`	`string<pending, converged, held, failed>`	כן	The last convergence pass's outcome. `held` is distinct from `failed` and means the zone could not be read, so nothing was changed — which is correct behaviour, not a fault.
`dns_authority`	`string<cloudflare, other, unknown>`	כן	Whose nameservers the zone was delegated to when last measured. `unknown` means the lookup did not answer — never that it is delegated elsewhere.
`catch_all`	`string`	כן	Where mail to any address on this domain is delivered. Empty when no forwarding alias exists — a domain with no deliverable destination gets no alias rather than one pointing…
`last_converged_at`	`string`	לא	When the world last agreed with the intended state.

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

401 · 403 · 404 · 429

GET /v1/mail/routing/{fqdn}