API

Toplu gönderim

Tek seferde en çok 100 tane.

POSTapi.openemail.uk/emails/batch

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

Öğe başına, asla hep ya da hiç değil

Her ileti tek tek kabul edilir ya da reddedilir ve yanıt ikisini de bildirir. Tek bir hatalı adres yüzünden geri alınan bir toplu gönderim, yeniden denemenizi hangi iletilerin çoktan gittiği sorusuna çevirirdi; oysa toplu gönderimi tam da bunu izlemek zorunda kalmamak için kullandınız.

Toplu gönderim

Gövde bir dizidir ya da { "emails": [...] } biçimindedir. Her ileti, tekil gönderimle aynı alanları alır.

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

Yanıt

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

200 değil 207: bir kısmı işe yaradı. Durum koduna göre dallanmak yerine öğe başına data[].status değerini okuyun.

Toplu gönderimdeki bir Idempotency-Key içeride öğe başına genişletilir; böylece yüz iletiye verilen tek bir anahtar hepsini ilk iletiye indirgemez.