API

Alan adlarını listeleme

Çalışma alanındaki her alan adı; alma, gönderme, izleme ve dosya durumlarıyla birlikte.

GETapi.openemail.uk/domains

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

GET /domains

Çalışma alanındaki her alan adı; alma, gönderme, izleme ve dosya durumlarıyla birlikte.

Alma ile gönderme ayrıdır

Her alan adı, almayı ve göndermeyi birbirinden bağımsız iki durum nesnesi olarak bildirir. receiving.verified, alan adının MX kaydının postasını buraya getirdiği ve sahiplik doğrulamasının yayımlandığı, yani alan adının teslimat alabileceği anlamına gelir. Giden posta hakkında hiçbir şey söylemez.

sending giden taraftır ve yeni bir denetimden değil, alan adının saklanan imzalama denetiminden okunur. sending.status şunlardan biridir: verified, pending, failed, no_identity veya unknown. sending.canSend alan adından yapılacak bir gönderimin şu anda kabul edilip edilmeyeceğini söyler, sending.checkedAt bu kararı tarihlendirir, sending.error son hatayı taşır ve sending.note durumu açıklayan bir cümledir. Bir günden eski olumsuz bir karar, ret değil bilinmeyen sayılır; bu yüzden status pending iken canSend true olabilir.

tracking, alan adının postasıyla değil, isteğe bağlı özel izleme alan adıyla ilgili üçüncü bir nesnedir. Biri ayarlanana kadar tracking.status none olur; ayarlama uygulamada ya da her alanı kendi sayfasında anlatılan PATCH /domains/{id} ile yapılır.

storage aynı alanlara sahip dördüncü bir nesnedir ve alan adının isteğe bağlı özel dosya alan adıyla ilgilidir: alan adından gönderilen dosyaların indirme bağlantılarının kullandığı ad. Aynı şekilde ve aynı sayfada ayarlanır; biri ayarlanana kadar storage.status none olur.

Örnek

domains:read gerektirir.

curl

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

Yanıt

{  "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 değerinin null olması DNS'e hiç bakılmadığı anlamına gelir: "başarısız oldu" değil, "henüz bakmadık". Bir alan adı eklendikten otuz saniye sonra bu ikisi çok farklı okunur.