Mail

messages

6 endpoints · /api/mail/v1/messages

Request examples are generated from each endpoint's REAL method and path. 6 endpoints have no hand-verified body example yet; their skeleton has no body — we do not invent field names.

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}.mail.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}.mail.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}.mail.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}.mail.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}.mail.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}.mail.blesyum.app/api/mail/v1/messages/undeliverable" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?