दस्तावेज़ पर जाएँ
नॉलेज बेस

ईमेल API

हर कॉल में एक संदेश या सौ भेजें, अभी या बाद में, और दो बार भेजे बिना दोबारा कोशिश करें।

विवरण

  • POST /emails एक संदेश भेजता है और POST /emails/batch 100 तक स्वतंत्र संदेश। बैच कभी सब या कुछ नहीं वाला नहीं होता: आइटम 7 पर गलत पता सिर्फ़ आइटम 7 को विफल करता है, बाकी फिर भी जाते हैं, और जवाब हर आइटम की अलग रिपोर्ट देता है।
  • सामग्री ठीक एक स्रोत से आती है: html और/या text, id या slug से कोई सहेजा गया टेम्पलेट (अगर टेक्स्ट किसी और का है तो उसका वर्ज़न पिन करें), या कोई मौजूदा ड्राफ़्ट। 10 टैग तक साथ जाते हैं और हर बार पढ़ने पर वापस मिलते हैं।
  • scheduledAt किसी संदेश को 365 दिन तक रोक सकता है, ISO 8601 समय या PT1H जैसी अवधि के रूप में। cancellableForSeconds तुरंत भेजे को 900 सेकंड तक की पूर्ववत मोहलत देता है। निकलने तक दोनों रद्द किए जा सकते हैं, और शेड्यूल किया गया भेजा फिर से शेड्यूल हो सकता है।
  • हर भेजे में एक Idempotency-Key होती है जो कुछ भी भेजे जाने से पहले आरक्षित हो जाती है, इसलिए टाइमआउट के बाद दोबारा कोशिश पहला नतीजा Idempotency-Replayed: true के साथ लौटाती है। अलग सामग्री के साथ वही कुंजी idempotency_key_reuse के रूप में अस्वीकार होती है।
  • हर भेजे का स्वीकार होते ही msg_ id होता है। GET /emails/{id} उसे पढ़ता है, /events हर प्राप्तकर्ता का ब्योरा देता है और /tracking ओपन व क्लिक।
  • translate जोड़ें और संदेश प्राप्तकर्ता की भाषा में डिलीवर होता है। अनुवाद अनुरोध स्वीकार होते समय होता है, इसलिए शेड्यूल किया गया भेजा वही शब्द रखता है जो आपने मंज़ूर किए, और जो अनुवाद न बन सके वह मूल पर लौटने के बजाय भेजना अस्वीकार कर देता है।
  • अटैचमेंट: 20 फ़ाइलों तक, इनलाइन फ़ाइलें कुल 5 MB तक। बड़ी फ़ाइल वर्कस्पेस की किसी फ़ाइल का id देकर भेजी जाती है और डाउनलोड लिंक के रूप में जाती है।
  • क्या नहीं है: अभी टेस्ट मोड नहीं है, इसलिए हर कुंजी सचमुच डिलीवर करती है, और भेजे की पंक्ति में बाउंस स्थिति नहीं है। बाउंस थ्रेड पर लेबल होता है और email.bounced वेबहुक के रूप में आता है, जबकि GET /emails अब भी sent दिखाता है।
  • सप्रेशन सूची, यानी सेटिंग्स में ब्लॉक किए गए पते, API पर भी है। GET /suppressions उसे खोज और कारण के फ़िल्टर के साथ पढ़ता है, POST /suppressions किसी पते को हाथ से ब्लॉक करता है, और DELETE /suppressions/{id} किसी पते को फिर से अनुमति देता है, सिवाय हार्ड बाउंस के, जो बना रहता है। SDK और MCP सर्वर भी यही करते हैं, और हर बदलाव suppression.added या suppression.removed वेबहुक चलाता है।