Gelen e-posta

evre, doğrulanmış bir domainde mail alabilir, parse edilmiş mesajı saklayabilir ve imzalı bir email.received webhook’u teslim edebilir.

Etkinleştir

Bir inbound route oluştur (veya enable’ın oluşturmasına izin ver):

curl -X POST https://api.evre.email/routes \
  -H "Authorization: Bearer $EVRE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Inbound","kind":"inbound","isDefault":true}'

Gönderim domainini doğrula, ardından inbound’u etkinleştir:

curl -X POST https://api.evre.email/domains/{id}/inbound \
  -H "Authorization: Bearer $EVRE_API_TOKEN"

Dönen MX kaydını yayınla (bounce.* MAIL FROM MX’ten farklı) ki mail SES inbound’a ulaşsın.

Webhook’lar

email.received olayına abone ol. Teslimat payload’u küçüktür; tam gövdeyi API üzerinden çek:

{
  "type": "email.received",
  "createdAt": "…",
  "data": {
    "email_id": "re_…",
    "routeId": "route_…",
    "from": "a@ex.com",
    "to": ["inbox@customer.com"],
    "subject": "…",
    "created_at": "…"
  }
}

Getir

GET /emails/received
GET /emails/received/{id}

SDK: client.emails.receiving.list() / .get(id)
CLI: evre emails received list|get

Yerel / mock ingest

curl -X POST https://api.evre.email/internal/inbound-emails \
  -H "Authorization: Bearer $EVRE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"a@ex.com","to":"inbox@customer.com","subject":"Hi","text":"hello"}'

Production SES

API servisinde şunları ayarla:

Env	Amaç
`EVRE_INBOUND_BUCKET`	Ham MIME için S3 bucket
`EVRE_INBOUND_RECEIPT_RULE_SET`	Paylaşılan SES receipt rule set (varsayılan `evre-inbound`)
`EVRE_INBOUND_SNS_TOPIC_ARN`	SNS topic → `POST /internal/ses-inbound`
`EVRE_INBOUND_SUBDOMAIN`	İsteğe bağlı alma host etiketi (boş = apex)
`EVRE_INBOUND_OBJECT_PREFIX`	S3 key prefix (varsayılan `inbound`)

SNS topic’ini https://api.evre.email/internal/ses-inbound adresine abone et (HTTPS confirmation otomatik işlenir).