Mail

domains

34 uç · /api/mail/v1/domains

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 34 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/mail/v1/domains

Admin journal listesi (metadata; en-yeni-önce, sayfalı+cap = OOM-güvenli).

Oturum
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains

Add

Oturum
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/mail/v1/domains/{id}

Remove

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/activate

Activate ep

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/activate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/bimi

Per-domain BIMI marka-logo ayarla/kaldır (BLE-3722). Set ise dns_records BIMI TXT üretir.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/bimi" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/catch-all

Set catch all ep

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/catch-all" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/dkim/keys

Dkim keys ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dkim/keys" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/dkim/rotate

Yeni DKIM anahtarı rotasyona al (zero-downtime): yeni selector+public_key döner (DNS'e eklenir).

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dkim/rotate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/dmarc-forensic

Domain forensic kayıtları (PII-siz spoofing-görünürlüğü paneli).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dmarc-forensic" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/dmarc-forensic

DMARC forensic (ruf) rapor alıcısı (BLE-3853) — **PII-DİKKATLİ**: yalnız spoofing-metadatası saklanır

OturumYol parametresi: id

(orijinal-mesaj alıcı/konu/gövde ASLA). Gövde = ham RFC 6591 AFRF raporu. Reported-Domain hedefle eşleşmeli (cross-domain guard).

İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dmarc-forensic" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/dmarc-report

DMARC agregat (rua) rapor alıcısı (BLE-3828): motor rua-mailbox teslimini gzip-açıp bu domain'e

OturumYol parametresi: id

forward eder → RFC 7489 Ek-C XML ayrıştır + MF11 ingest. Gövde = ham rapor XML'i (String). Raporun `policy_published/domain`'i hedef domain ile eşleşmeli (cross-domain karışma yok).

İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dmarc-report" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/dmarc-summary

Dmarc summary ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dmarc-summary" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/dns

Dns

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/dns" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/inbound-policy

Inbound policy

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/inbound-policy" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/inbound-policy

Gelen anti-spoofing/spam politikasını ayarla (motorun uygulayacağı per-domain).

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/inbound-policy" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/mta-sts

MTA-STS mod-durumu (mode + version + DNS policy-id).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/mta-sts" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/mta-sts

MTA-STS modunu değiştir (testing→enforce promosyonu). Mod değişirse version+id artar (senderlar

OturumYol parametresi: id

yeni politikayı çeker); DNS'e yeni id yayınlanması (müşteri/CF) canlı-etki için gereklidir (MF16).

İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/mta-sts" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/over-quota-action

Domain kota-aşım politikası (warn_only|block_incoming; BLE-3553). audit'li.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/over-quota-action" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/readiness

Kesim-öncesi hazırlık raporu (BLE-3802) — MX'i Bmail'e çevirmeden ÖNCE domain'in

OturumYol parametresi: id

ownership/SPF/DKIM/DMARC/MTA-STS/TLS-RPT durumunu CANLI (hickory) DNS'e karşı değerlendirir → GO/WARN/FAIL. `/verify` tekil-aktive-eder; bu uç YALNIZ salt-okunur go/no-go raporu (kesim-kararı, yan-etkisiz). Beklenen kayıtlar `/dns` ile AYNI config'ten üretilir (tutarlı: müşteriye söylediğimiz kayıtlara karşı kontrol). `cutover_readiness` çekirdeği (readiness.rs) tamamen test'li; bu uç onu canlı resolver'la ERİŞİLEBİLİR kılar.

İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/readiness" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/reputation

Birleşik itibar paneli + eşik-alarm (BLE-3896/3899/3862/3855): per-domain teslim/bounce/şikayet

OturumYol parametresi: id

oranı + DMARC-hizalama + TLS-başarı metrikleri + varsayılan-eşik alarm değerlendirmesi.

İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/reputation" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/reputation-thresholds

Efektif itibar-eşiklerini getir (özel-override ya da varsayılan) + özelleştirilmiş mi (BLE-3903).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/reputation-thresholds" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/reputation-thresholds

Set thresholds ep

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/reputation-thresholds" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/mail/v1/domains/{id}/reputation-thresholds

Özel eşiği kaldır → varsayılana dön (BLE-3903).

OturumYol parametresi: id
İstek
curl -X DELETE "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/reputation-thresholds" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/retention

Get retention

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/retention" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/retention

Set retention

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/retention" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/retention-history

Saklama-politikası değişim geçmişi (BLE-3861 denetim; eski→yeni + kim + ne zaman).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/retention-history" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/sender-rules

List sender rules ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/sender-rules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/sender-rules

Add sender rule ep

OturumYol parametresi: id
İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/sender-rules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/tls-rpt

TLS-RPT rua alıcısı (BLE-3530): motor mailto-teslimini ya da https-rua raporunu bu domain'e forward

OturumYol parametresi: id

eder → RFC 8460 JSON ayrıştır + MF11 ingest. Gövde = ham rapor JSON'u (String; en son extractor). Raporun yalnız bu domain'e ait politikaları kaydedilir (cross-domain karışma yok).

İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/tls-rpt" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/tls-summary

Tls summary ep

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/tls-summary" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/mail/v1/domains/{id}/verify

Ownership + temel mail-DNS'i CANLI (hickory) DNS ile doğrula → geçerse aktive-et (BLE-3520).

OturumYol parametresi: id

TXT-challenge + gerçek DNS lookup çekirdeği (`verify::verify_domain`/`verify_and_persist`) hazırdı; bu uç onu ERİŞİLEBİLİR kılar (kullanıcı "şimdi doğrula"). Periyodik toplu-sweep = scheduler (MF3/16).

İstek
curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/verify" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/mail/v1/domains/{id}/warmup

Domain warmup durumu (yaş + günlük-cap + safe-sender exempt; BLE-3656).

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/warmup" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PUT/api/mail/v1/domains/{id}/warmup-exempt

Domain'i warmup'tan muaf tut/kaldır (safe-sender allowlist; güvenilir gönderen). audit'li.

OturumYol parametresi: id
İstek
curl -X PUT "https://{slug}.bmail.blesyum.app/api/mail/v1/domains/<id>/warmup-exempt" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al