API
Gửi theo lô
Tối đa 100 thư mỗi lần.
POSTapi.openemail.uk/emails/batch
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
Theo từng mục, không bao giờ là tất cả hoặc không có gì
Mỗi thư được chấp nhận hoặc từ chối riêng, và phản hồi báo cáo cả hai. Nếu một lô bị hoàn tác chỉ vì một địa chỉ sai, lần thử lại của bạn sẽ trở thành bài toán xác định thư nào đã được gửi đi, đó chính là điều bạn dùng lô để khỏi phải theo dõi.
Gửi theo lô
Phần thân là một array, hoặc { "emails": [...] }. Mỗi thư nhận cùng các trường như một lần gửi đơn lẻ.
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, không phải 200: chỉ một phần thành công. Hãy đọc data[].status của từng mục thay vì rẽ nhánh theo mã trạng thái.
Idempotency-Key trên một lô được mở rộng nội bộ cho từng mục, nên một khóa cho một trăm thư sẽ không gộp tất cả thành thư đầu tiên.