Belgelere geç
API

Web uygulaması adresini getirme

Çalışma alanının web uygulaması adresi, orada oturum açılıp açılamadığı ve gerektirdiği CNAME kaydı. Hiç adres ayarlanmamışsa `status` değeri `none` olur ve `domains`, adresin altında yer alabileceği alan adlarını listeler.

GET/app-host

Gerçek çağrıyı çalışma alanınızda çalıştırır.

GET /app-host

Çalışma alanının web uygulaması adresi, orada oturum açılıp açılamadığı ve gerektirdiği CNAME kaydı. Hiç adres ayarlanmamışsa status değeri none olur ve domains, adresin altında yer alabileceği alan adlarını listeler.

Web uygulaması adresi nedir

shell
export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

Ücretli bir plandaki çalışma alanı web uygulamasını yalnızca openemail.uk üzerinde değil, doğrulanmış alan adlarından birinin mailbox.acme.com gibi bir alt alan adında da açabilir. Bu, çalışma alanının Görünüm ayarlarındaki Markalı uygulama sekmesinin ayarladığı adrestir ve bir çalışma alanında en fazla bir tane olur.

Orada yalnızca çalışma alanının üyeleri, adreslerinden biriyle oturum açan kişiler ve bekleyen bir daveti olan herkes oturum açabilir; oradan gönderilen parola sıfırlama ve doğrulama e-postalarını da yalnızca onlar alır. Çalışma alanı Görünüm sayfasında bir logo ayarlayana kadar openemail.uk gibi görünür, ardından bizimkiler yerine çalışma alanının logosunu, işaretini ve adını gösterir. O andan itibaren OpenEmail'in onlara gönderdiği e-postalar markayı taşır, bu adrese geri bağlanır ve o alan adının imzalama kayıtları doğrulandığında alan adının noreply@ adresinden gelir.

Tek bir CNAME kaydı gerektirir; kaydın ayrıntılarını record verir. Adres, kayıt yanıt verip sertifikası verilene kadar pending, sonrasında active olur. Ücretsiz planda adres korunur ama duraklatılır: paused true olur ve çalışma alanı yeniden ücretli bir plana geçene kadar orada kimse oturum açamaz.

Örnek

domains:read gerektirir.

curl
curl "$OE/app-host" -H "$AUTH"
Yanıt
{  "object": "app_host",  "id": "ahost_3f9c2a71d0b84e56a1c7f2e9",  "host": "mailbox.acme.com",  "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",  "domain": "acme.com",  "status": "active",  "active": true,  "paused": false,  "target": "cname.openemail.uk",  "record": {    "type": "CNAME",    "name": "mailbox.acme.com",    "value": "cname.openemail.uk"  },  "error": null,  "checkedAt": "2026-10-01T09:12:30.000Z",  "verifiedAt": "2026-10-01T09:04:11.000Z",  "available": true,  "paidPlan": true,  "domains": ["acme.com"],  "suggested": "mailbox.acme.com"}

Adresi okumak, son denetimi 15 saniyeden eskiyse onu yeniden denetler; bu yüzden active değerinin true olmasını beklemenin yolu bu uç noktayı yoklamaktır.

active yalnızca status değeri active olduğunda ve çalışma alanı ücretli bir plandayken true olur. paused, bir adres ayarlıyken ve çalışma alanı ücretsiz plandayken true olur.

Gelen kutunuz,
kendi kurallarınızla.

İşletmeler, yapay zekâ, ajanlar ve kişisel e-posta için e-posta altyapısı. Ölçek, gizlilik ve denetim için kuruldu. E-postanın ilk günden sahip olması gereken her şey.

© 2026 OpenEmail. Tüm hakları saklıdır.