दस्तावेज़ पर जाएँ
API

batch भेजें

एक बार में 100 तक।

POSTapi.openemail.uk/emails/batch

असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।

प्रति आइटम, कभी सब-या-कुछ-नहीं नहीं

हर संदेश अपने आप स्वीकार या अस्वीकार होता है और प्रतिक्रिया दोनों बताती है। जो batch एक ग़लत पते पर पूरा रोलबैक कर देता, वह आपके पुनः प्रयास को इस सवाल में बदल देता कि कौन-से संदेश पहले ही जा चुके थे — और batch आपने इसी हिसाब-किताब से बचने के लिए इस्तेमाल किया था।

batch भेजें

बॉडी एक array है, या { "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 पढ़ें।

batch पर दी गई Idempotency-Key अंदरूनी तौर पर हर आइटम के लिए बढ़ा दी जाती है, इसलिए सौ संदेशों पर एक कुंजी उन्हें पहले संदेश में ढहा नहीं देती।