messages — Mail API

GET/api/mail/v1/messages

Giden mesaj teslim-durumu listesi. `?message_id=` verilirse tek kaydı döndürür; aksi halde

Oturum

`?status=` filtresi + `?limit=` (defensif [1,500]) ile son kayıtlar.

İstek

curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/messages" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/mail/v1/messages/lane-defaults

Şerit itibar-koruyucu varsayılanları (bülten vs işlemsel; ?lane= — BLE-3732).

Oturum

İstek

curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/messages/lane-defaults" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/mail/v1/messages/queue-metrics

Kuyruk-sağlık metrikleri (şerit×durum matrisi + uçuşta/teslim/DLQ + teslim-oranı).

Oturum

İstek

curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/messages/queue-metrics" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/mail/v1/messages/stats

Send log stats

Oturum

İstek

curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/messages/stats" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/mail/v1/messages/status

MOTOR (Stalwart) teslim-durumu geçişi raporu → send_log güncelle + GERÇEK geçişte

Oturum

`mail.message.<status>` webhook'unu dispatch et (best-effort; log-commit otoritatif).

İstek

curl -X POST "https://{slug}.bmail.blesyum.app/api/mail/v1/messages/status" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/mail/v1/messages/undeliverable

Kalıcı teslim-edilemez mesaj raporu (terminal bounced/failed + retry-eğrisini tüketmiş deferred).

Oturum

İstek

curl -X GET "https://{slug}.bmail.blesyum.app/api/mail/v1/messages/undeliverable" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}