Enviar un lot
Fins a 100 alhora.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
Per element, mai tot o res
Cada missatge s'accepta o es rebutja pel seu compte i la resposta informa dels dos casos. Un lot que es desfés per una sola adreça incorrecta convertiria el vostre reintent en la pregunta de quins missatges ja havien sortit, que és precisament el que volíeu evitar haver de controlar en utilitzar un lot.
Enviar un lot
El cos és un array, o bé { "emails": [...] }. Cada missatge accepta els mateixos camps que un enviament individual.
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, no 200: una part ha funcionat. Llegiu data[].status element per element en lloc de ramificar segons el codi d'estat.
Una Idempotency-Key en un lot s'amplia internament per element, de manera que una sola clau per a cent missatges no els col·lapsa tots en el primer.