API

Pobieranie domeny

Dokłada adresy istniejące na domenie oraz to, czy każdy z nich jest włączony.

GETapi.openemail.uk/domains/{id}

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

GET /domains/{id}

Dokłada adresy istniejące na domenie oraz to, czy każdy z nich jest włączony.

Przykład

Wymaga domains:read.

curl

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

Odpowiedź

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

Wyłączony adres przestaje przyjmować doręczenia. Poczta do niego jest odrzucana już na poziomie SMTP, więc nadawca dostaje zwrotkę, a nie ciszę.

Czego jeszcze tu nie zrobisz

Jeszcze niedostępne

Zapisy, jakie przyjmuje ten zasób, to własna domena śledząca i własna domena plików, obie przez PATCH /domains/{id}. Reszta konfiguracji domeny jest na razie dostępna tylko w aplikacji.

Dodanie domeny i odczytanie rekordów DNS do opublikowania. GET zgłasza, że domena jest niezweryfikowana, ale nie mówi, którego rekordu brakuje.
Wymuszenie ponownego sprawdzenia receiving albo sending. Żadne nie ma endpointu i żadne go nie potrzebuje: cogodzinny przegląd sam sprawdza ponownie każdą niezweryfikowaną domenę, więc opublikowanie rekordów i zostawienie ich to cała robota. Zamiast odpytywać GET /domains, zasubskrybuj domain.verified i domain.sending_changed, a dowiesz się w chwili, gdy którekolwiek drgnie. PATCH /domains/{id} sprawdza tylko domenę śledzącą i domenę plików.
Utworzenie, wyłączenie lub trasowanie adresu. UDOSTĘPNIANIE jest gotowe, bo POST /members/{userId}/addresses przekazuje istniejący adres komuś na poziomie member lub viewer. To powołania adresu do istnienia ten zasób nie potrafi.

Wszystko to istnieje w aplikacji w Ustawienia → Domeny. Brakuje powierzchni API, a nie możliwości.