API
Odeslání dávky
Až 100 najednou.
POSTapi.openemail.uk/emails/batch
Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.
Po položkách, nikdy všechno nebo nic
Každá zpráva se přijme nebo odmítne samostatně a odpověď hlásí obojí. Dávka, která by se kvůli jedné špatné adrese celá vrátila zpět, by z opakovaného volání udělala otázku, které zprávy už odešly – a právě sledování tohohle jste se použitím dávky chtěli vyhnout.
Odeslání dávky
Tělo je pole, nebo { "emails": [...] }. Každá zpráva přijímá stejná pole jako jednotlivé odeslání.
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, ne 200: něco z toho vyšlo. Čtěte data[].status u každé položky, místo abyste větvili podle stavového kódu.
Idempotency-Key u dávky se interně rozšiřuje pro každou položku, takže jeden klíč na sto zpráv je nesloučí do té první.