API

Domain lekérése

Hozzáteszi a rajta létező címeket és azt, hogy mindegyik engedélyezett-e.

GETapi.openemail.uk/domains/{id}

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

GET /domains/{id}

Hozzáteszi a rajta létező címeket és azt, hogy mindegyik engedélyezett-e.

Példa

domains:read szükséges hozzá.

curl

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

Válasz

{  "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"}

A letiltott cím megszűnik kézbesíthető lenni. A rá érkező levelet SMTP időben elutasítja, így a feladó visszapattanást kap, nem csendet.

Amit itt még nem tudsz megtenni

Még nem érhető el

Ez az erőforrás az egyéni követési domaint és az egyéni fájldomaint fogadja írásként, mindkettőt a PATCH /domains/{id} hívással. Egy domain beállításának többi része egyelőre csak az alkalmazásban érhető el.

Domain hozzáadása és a közzéteendő DNS rekordok kiolvasása. A GET jelenti, hogy egy domain nincs hitelesítve, de azt nem, melyik rekord hiányzik.
A receiving vagy a sending újraellenőrzésének kiváltása. Egyikhez sincs végpont, és egyiknek sincs rá szüksége: egy óránkénti seprés magától újraellenőriz minden nem hitelesített domaint, így a rekordok közzététele és békén hagyása a teljes feladat. A GET /domains pollozása helyett iratkozz fel a domain.verified és a domain.sending_changed eseményre, és abban a pillanatban értesülsz, amint bármelyik elmozdul. A PATCH /domains/{id} csak a követési domaint és a fájldomaint ellenőrzi.
Cím létrehozása, letiltása vagy irányítása. A MEGOSZTÁS megvan, mert a POST /members/{userId}/addresses egy meglévő címet ad át valakinek member vagy viewer szinten. Ez az erőforrás azt nem tudja, hogy a címet létrehozza.

Mindez létezik az alkalmazásban a Beállítások → Domainek alatt. Az API felület hiányzik, nem a képesség.