Belgelere geç
API

Alan adı getirme

Alan adında var olan adresleri ve her birinin etkin olup olmadığını ekler.

GETapi.openemail.uk/domains/{id}

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

GET /domains/{id}

Alan adında var olan adresleri ve her birinin etkin olup olmadığını ekler.

Örnek

domains:read gerektirir.

curl
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f" -H "$AUTH"
Yanıt
{  "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"}

Devre dışı bırakılan bir adrese teslimat yapılamaz. Ona gelen posta SMTP sırasında reddedilir; böylece gönderen sessizlik yerine bir bounce bildirimi alır.

Burada henüz yapamadıklarınız

Henüz yayımlanmadı

Bu kaynağın kabul ettiği yazma işlemleri özel izleme alan adı ve özel dosya alan adıdır; ikisi de PATCH /domains/{id} üzerinden yapılır. Bir alan adının kurulumunun geri kalanı şimdilik yalnızca uygulamada yapılabilir.

  • Alan adı ekleme ve yayımlanacak DNS kayıtlarını okuma. GET, bir alan adının doğrulanmadığını bildirir ama hangi kaydın eksik olduğunu söylemez.
  • receiving ya da sending için yeniden denetim tetikleme. İkisinin de uç noktası yok ve gerek de yok: saatlik bir tarama doğrulanmamış her alan adını kendiliğinden yeniden denetler, yani kayıtları yayımlayıp bırakmak işin tamamıdır. GET /domains yoklamak yerine domain.verified ve domain.sending_changed olaylarına abone olun; ikisinden biri değiştiği anda haberdar edilirsiniz. PATCH /domains/{id} yalnızca izleme alan adını ve dosya alan adını denetler.
  • Adres oluşturma, devre dışı bırakma veya yönlendirme. Bir adresi PAYLAŞMAK yapılabiliyor: POST /members/{userId}/addresses, var olan bir adresi birine member ya da viewer düzeyinde veriyor. Bu kaynağın yapamadığı şey, adresi var etmek.

Bunların hepsi uygulamada Settings → Domains altında var. Eksik olan yetenek değil, API yüzeyi.