API

Načtení domény

Přidává adresy, které na ní existují, a informaci, zda je každá z nich zapnutá.

GETapi.openemail.uk/domains/{id}

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

GET /domains/{id}

Přidává adresy, které na ní existují, a informaci, zda je každá z nich zapnutá.

Příklad

Vyžaduje domains:read.

curl

curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f" -H "$AUTH"

Odpověď

{  "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  },  "addresses": [    { "address": "[email protected]", "enabled": true },    { "address": "[email protected]", "enabled": false }  ],  "createdAt": "2026-08-14T09:55:11.000Z"}

Vypnutá adresa přestane být doručitelná. Pošta na ni se odmítne už při SMTP, takže odesílatel dostane bounce, ne ticho.

Co tady zatím nejde

Zatím nevydáno

Zápisy, které tento zdroj přijímá, jsou vlastní doména pro sledování a vlastní doména pro soubory, obojí přes PATCH /domains/{id}. Zbytek nastavení domény je zatím jen v aplikaci.

Přidání domény a načtení DNS záznamů, které se mají publikovat. GET oznámí, že doména není ověřená, ale ne který záznam chybí.
Spuštění opětovné kontroly receiving nebo sending. Ani jedno nemá endpoint a ani jedno ho nepotřebuje: hodinový průchod sám znovu zkontroluje každou neověřenou doménu, takže publikovat záznamy a nechat je být je celá práce. Místo dotazování GET /domains se přihlaste k odběru domain.verified a domain.sending_changed a dozvíte se to v okamžiku, kdy se kterýkoli z nich pohne. PATCH /domains/{id} kontroluje jen doménu pro sledování a doménu pro soubory.
Vytvoření, vypnutí nebo směrování adresy. SDÍLENÍ hotové je, protože POST /members/{userId}/addresses předá existující adresu někomu na úrovni member nebo viewer. Co tento zdroj neumí, je přivést adresu na svět.

Všechno to v aplikaci existuje pod Nastavení → Domény. Chybí API, ne ta schopnost.