GET /v1/mail/routing/{fqdn}
How one domain's mail is routed.
Hitelesítés
Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) mail.view jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.
Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.
Próbálja ki
Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.
curl -X GET https://api.zinndigital.com/v1/mail/routing/{fqdn} \
-H "Authorization: Bearer zdk_live_…"Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban
Részletek
Requires mail.view.
Paraméterek
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
fqdn (path) | string | Igen | The hostname whose mail routing is being read or changed. |
Válasz
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
fqdn | string | Igen | The domain this routing is for. |
mechanism | string<zinn_mailbox, zinn_forward, cloudflare_routing, external, none> | Igen | 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 | Igen | Why this mechanism was chosen, in a sentence a person can act on. |
forwards | boolean | Igen | Whether mail is passed on rather than stored. |
stores | boolean | Igen | Whether this domain has real mailboxes on our relay. |
status | string<pending, converged, held, failed> | Igen | 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> | Igen | 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 | Igen | 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 | Nem | When the world last agreed with the intended state. |
Hibák, amelyeket ez a végpont visszaadhattatlan
401 · 403 · 404 · 429