API
ارسال دستهای
تا ۱۰۰ تا با هم.
POSTapi.openemail.uk/emails/batch
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
بهازای هر مورد، هرگز همهیاهیچ
هر پیام جداگانه پذیرفته یا رد میشود و پاسخ هر دو را گزارش میدهد. دستهای که بهخاطر یک نشانی بد عقبگرد میکرد، تلاش دوبارهٔ شما را به این پرسش بدل میکرد که کدام پیامها پیشتر رفتهاند، و شما دقیقاً برای پینگرفتن همین بود که از دسته استفاده کردید.
ارسال دستهای
بدنه یک آرایه است، یا { "emails": [...] }. هر پیام همان فیلدهای یک ارسال تکی را میگیرد.
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 روی یک دسته در داخل بهازای هر مورد گسترش مییابد، پس یک کلید روی صد پیام آنها را در اولی فرو نمیریزد.