GET /v1/mail/routing/{fqdn}
How one domain's mail is routed.
Doğrulama
API açarını bearer token kimi göndərin. Açar mail.view icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X GET https://api.zinndigital.com/v1/mail/routing/{fqdn} \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
Requires mail.view.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
fqdn (path) | string | Bəli | The hostname whose mail routing is being read or changed. |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
fqdn | string | Bəli | The domain this routing is for. |
mechanism | string<zinn_mailbox, zinn_forward, cloudflare_routing, external, none> | Bəli | 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 | Bəli | Why this mechanism was chosen, in a sentence a person can act on. |
forwards | boolean | Bəli | Whether mail is passed on rather than stored. |
stores | boolean | Bəli | Whether this domain has real mailboxes on our relay. |
status | string<pending, converged, held, failed> | Bəli | 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> | Bəli | 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 | Bəli | 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 | Xeyr | When the world last agreed with the intended state. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 429