GET /v1/mail/routing/{fqdn}
How one domain's mail is routed.
Аутентификация
API кілтін bearer токені ретінде жіберіңіз. Кілтте mail.view рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.
Бұл соңғы нүкте ұйым идентификаторын қабылдамайды. Сіздің кілтіңіз оның қай ұйымға тиесілі екенін өзі анықтайды және жауап соған шектеледі.
Әрекет етіп көру
Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.
curl -X GET https://api.zinndigital.com/v1/mail/routing/{fqdn} \
-H "Authorization: Bearer zdk_live_…"Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз
Мәліметтер
Requires mail.view.
Параметрлер
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
fqdn (path) | string | Иә | The hostname whose mail routing is being read or changed. |
Жауап
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
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