API
Köteg küldése
Legfeljebb 100 egyszerre.
POSTapi.openemail.uk/emails/batch
A valódi hívást futtatja le a munkaterületén, a saját kulcsával.
Tételenként, soha nem mindent vagy semmit
Minden üzenetet külön fogadunk el vagy utasítunk el, és a válasz mindkettőről beszámol. Az a köteg, amely egyetlen rossz cím miatt visszagördülne, az újrapróbálkozást azzá a kérdéssé tenné, mely üzenetek mentek már ki, márpedig pont ennek a nyilvántartását akartad elkerülni a köteggel.
Köteg küldése
A törzs egy tömb, vagy { "emails": [...] }. Minden üzenet ugyanazokat a mezőket veszi át, mint egy önálló küldés.
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, nem 200: valami sikerült belőle. A státuszkód helyett tételenként a data[].status mezőt olvasd.
A kötegre tett Idempotency-Key kulcsot belül tételenként kiterjesztjük, így egyetlen kulcs száz üzeneten nem olvasztja őket az elsőbe.