تخطَّ إلى المستندات
API

إرسال دفعة

حتى 100 دفعةً واحدة.

POSTapi.openemail.uk/emails/batch

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

لكل عنصر، لا الكل أو لا شيء

تُقبل كل رسالة أو تُرفض على حدة، وتبلّغ الاستجابة عن الأمرين. فالدفعة التي تتراجع كاملة بسبب عنوان واحد خاطئ تحوّل إعادة محاولتك إلى سؤال عن أي الرسائل ذهبت بالفعل، وهو ما استخدمت الدفعة أصلًا لتتجنّب تتبّعه.

إرسال دفعة

جسم الطلب مصفوفة، أو { "emails": [...] }. وكل رسالة تأخذ الحقول نفسها التي يأخذها إرسال مفرد.

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>" }    ]  }'
الاستجابة
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 لا 200: فبعضها نجح. اقرأ data[].status لكل عنصر بدلًا من التفريع على رمز الحالة.

تُمدَّد ترويسة Idempotency-Key على دفعة لكل عنصر داخليًا، فمفتاح واحد على مئة رسالة لا يطويها في الرسالة الأولى.