API

Seznam domén

Každá doména ve workspace se svým stavem příjmu, odesílání, sledování a souborů.

GETapi.openemail.uk/domains

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

GET /domains

Každá doména ve workspace se svým stavem příjmu, odesílání, sledování a souborů.

Příjem a odesílání jsou oddělené

Každá doména hlásí příjem a odesílání jako dva nezávislé stavové objekty. receiving.verified znamená, že MX domény přivádí její poštu sem a že je publikovaná výzva k prokázání vlastnictví, takže doména může přijímat doručení. O odchozí poště to neříká nic.

sending je odchozí polovina, čtená z uložené kontroly podepisování dané domény, ne z čerstvé. sending.status je jedno z verified, pending, failed, no_identity nebo unknown, sending.canSend říká, jestli by odeslání z domény bylo právě teď přijato, sending.checkedAt datuje tento verdikt, sending.error nese poslední selhání a sending.note je věta vysvětlující stav. Negativní verdikt starší než den se bere jako neznámý, ne jako odmítnutí, takže canSend může být true, zatímco status je pending.

tracking je třetí objekt a týká se volitelné vlastní domény pro sledování, ne pošty. tracking.status je none, dokud nějakou nenastavíte – v aplikaci nebo přes PATCH /domains/{id}, na jehož stránce je popsané každé pole.

storage je čtvrtý objekt se stejnými poli a týká se volitelné vlastní domény pro soubory: názvu, který používají odkazy ke stažení souborů odeslaných z této domény. Nastavuje se stejně a na téže stránce a storage.status je none, dokud nějakou nenastavíte.

Příklad

Vyžaduje domains:read.

curl

curl "$OE/domains" -H "$AUTH"

Odpověď

{  "object": "list",  "data": [    {      "object": "domain",      "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",      "domain": "acme.com",      "receiving": {        "verified": true,        "verifiedAt": "2026-08-14T10:02:00.000Z",        "catchAll": false,        "lastCheckedAt": "2026-08-29T06:00:00.000Z",        "error": null      },      "sending": {        "status": "verified",        "canSend": true,        "checkedAt": "2026-08-29T06:00:00.000Z",        "error": null,        "note": "Mail from this domain is signed and can be sent."      },      "tracking": {        "host": "links.acme.com",        "status": "active",        "active": true,        "target": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk",        "record": { "type": "CNAME", "name": "links.acme.com", "value": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk" },        "checkedAt": "2026-08-29T06:10:00.000Z",        "verifiedAt": "2026-08-29T06:10:00.000Z",        "error": null      },      "storage": {        "host": "files.acme.com",        "status": "active",        "active": true,        "target": "oefiles81c40d6b2f7e9a35.edge.openemail.uk",        "record": { "type": "CNAME", "name": "files.acme.com", "value": "oefiles81c40d6b2f7e9a35.edge.openemail.uk" },        "checkedAt": "2026-08-29T06:10:00.000Z",        "verifiedAt": "2026-08-29T06:10:00.000Z",        "error": null      },      "createdAt": "2026-08-14T09:55:11.000Z"    }  ]}

lastCheckedAt s hodnotou null znamená, že se do DNS ještě nikdo nedíval: „zatím jsme se nedívali“, ne „selhalo to“. Třicet vteřin po přidání domény se to čte velmi odlišně.