API

Een batch verzenden

Tot 100 tegelijk.

POSTapi.openemail.uk/emails/batch

Voert de echte aanroep uit op je workspace, met je eigen sleutel.

Per item, nooit alles-of-niets

Elk bericht wordt op zichzelf geaccepteerd of geweigerd en het antwoord meldt beide. Een batch die op één fout adres zou terugdraaien, maakt van je nieuwe poging de vraag welke berichten al weg waren, en dat is precies wat je met een batch niet wilde bijhouden.

Een batch verzenden

De body is een array, of { "emails": [...] }. Elk bericht neemt dezelfde velden als een enkele verzending.

curl

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>" }    ]  }'

Antwoord

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, niet 200: een deel is gelukt. Lees data[].status per item in plaats van te vertakken op de statuscode.

Een Idempotency-Key op een batch wordt intern per item uitgebreid, dus één sleutel op honderd berichten laat ze niet samenvallen met het eerste.