پرش به مستندات
API

ارسال دسته‌ای

تا ۱۰۰ تا با هم.

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 روی یک دسته در داخل به‌ازای هر مورد گسترش می‌یابد، پس یک کلید روی صد پیام آن‌ها را در اولی فرو نمی‌ریزد.