Batch-Versand

Bis zu 100 E-Mails in einem Aufruf einreihen, alles oder nichts.

Ein Aufruf, bis zu 100 E-Mails

POST /v1/emails/batch nimmt ein Array von 1 bis 100 E-Mails mit denselben Feldern wie ein einzelner Versand. Die Antwort (202) listet pro E-Mail id und status in der Reihenfolge der Anfrage.

curl https://api.letr.dev/v1/emails/batch \
  -H "Authorization: Bearer $LETR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"from": "Acme <[email protected]>", "to": "[email protected]", "subject": "Receipt 1042", "text": "Thanks."},
    {"from": "Acme <[email protected]>", "to": "[email protected]", "subject": "Receipt 1043", "text": "Thanks."}
  ]'

{ "data": [{ "id": "...", "status": "queued" }, { "id": "...", "status": "queued" }] }

Alles oder nichts

letr.dev prüft jede E-Mail, rechnet den ganzen Batch an Ihre Limiten an und speichert ihn in einer Transaktion. Scheitert eine E-Mail, wird keine eingereiht. Die Fehlermeldung nennt die Position, zum Beispiel [3].to für die vierte E-Mail. Ein Batch, der Ihre Monatsobergrenze oder die Tageslimite überschreiten würde, ergibt 429; ein leeres Array oder mehr als 100 E-Mails ergeben 422 invalid_batch.

Wiederholen

Ein Idempotency-Key gilt für den ganzen Batch: Eine Wiederholung mit gleichem Key und Inhalt liefert die IDs und den aktuellen Status des ersten Batches und versendet nichts, siehe Wiederholen ohne Duplikate.