Einen Batch senden
Bis zu 100 auf einmal.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
Pro Eintrag, nie alles oder nichts
Jede Nachricht wird für sich angenommen oder abgelehnt, und die Antwort meldet beides. Ein Batch, der wegen einer fehlerhaften Adresse komplett zurückgerollt würde, machte aus Ihrem erneuten Versuch die Frage, welche Nachrichten bereits hinaus waren, und genau das wollten Sie mit einem Batch nicht mitverfolgen müssen.
Einen Batch senden
Der Body ist ein Array oder { "emails": [...] }. Jede Nachricht nimmt dieselben Felder wie ein Einzelversand.
curl -X POST "$OE/emails/batch" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "emails": [ { "from": "[email protected]", "to": ["[email protected]"], "subject": "Invoice", "html": "<p>1</p>" }, { "from": "[email protected]", "to": ["[email protected]"], "subject": "Invoice", "html": "<p>2</p>" }, { "from": "[email protected]", "to": ["broken@"], "subject": "Invoice", "html": "<p>3</p>" } ] }'HTTP/1.1 207 Multi-Status { "object": "list", "sent": 1, "failed": 2, "data": [ { "index": 0, "status": "ok", "email": { "id": "msg_e7e468…", "status": "sent" } }, { "index": 1, "status": "error", "error": { "type": "permission_error", "code": "from_address_forbidden", "param": "from" } }, { "index": 2, "status": "error", "error": { "type": "validation_error", "code": "invalid_email_address", "param": "to.0" } } ]}207, nicht 200: Ein Teil davon hat funktioniert. Lesen Sie data[].status pro Eintrag, statt über den Statuscode zu verzweigen.
Ein Idempotency-Key auf einem Batch wird intern pro Eintrag erweitert; ein einzelner Key auf hundert Nachrichten lässt diese also nicht in der ersten zusammenfallen.