प्रेषण एवं संचालन

API 0.16.0OpenAPIllms-full.txt

एक पत्र कतारबद्ध करें

GET /v1/mailboxes. से ID बॉक्स प्राप्त करें एक सबमिशन के लिए एक अद्वितीय Idempotency-Key बनाएं और इसे अंतिम परिणाम तक सहेजें। नेटवर्क रीप्ले के लिए, समान कुंजी और समान बॉडी का उपयोग करें।

HTTP 202 एक ऑपरेशन ऑब्जेक्ट लौटाता है, डिलीवरी पुष्टिकरण नहीं। फ़ील्ड id में ID ऑपरेशन शामिल हैं। पोल GET /v1/operations/{operation_id}.

POST /v1/mailboxes/42/send
Idempotency-Key: message-20261019-0001
Content-Type: application/json

{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}

परिणाम को कैसे समझें

queued

पत्र भेजे जाने की प्रतीक्षा की जा रही है.

running

भेजने का कार्य प्रगति पर है.

succeeded

मेल सर्वर ने सबमिशन स्वीकार कर लिया. प्रत्येक प्राप्तकर्ता के लिए परिणाम की जाँच करें.

failed

भेजना विफल रहा. कारण error. में दिया गया है

cancelled

प्रेषण रद्द कर दिया गया.

uncertain

भेजे गए परिणाम की पुष्टि करने में विफल. कृपया दोबारा प्रयास करने से पहले ऑपरेशन और अपने भेजे गए फ़ोल्डर की जांच करें।

सफल प्रेषण के बाद, result फ़ील्ड में accepted_recipients - स्वीकृत प्राप्तकर्ता, rejected_recipients - अस्वीकृत प्राप्तकर्ता और sent_saved - भेजे गए में एक प्रति सहेजने का परिणाम शामिल होता है। मेल सर्वर द्वारा किसी पत्र की स्वीकृति प्राप्तकर्ता के इनबॉक्स में डिलीवरी की गारंटी नहीं देती है।

किसी लंबित प्रेषण को रद्द करने के लिए, POST /v1/operations/{operation_id}/cancel. चलाएँ /retry विधि ईमेल को दोबारा नहीं भेजती है।

उत्तर, अग्रेषित और विलंबित प्रेषण

उत्तर देने के लिए, कृपया reply_to_message_id में मूल ईमेल का message_id शामिल करें और इसे references. पर अग्रेषित करें to में, reply_to से उत्तर पता या प्रेषक का पता दर्ज करें। सभी को उत्तर देने के लिए, अपने पते को छोड़कर, अन्य प्रतिभागियों को to और cc में जोड़ें।

अनुलग्नकों को अग्रेषित करने के लिए, folder, uidvalidity और uid. के साथ forward_message पास करें। अपनी अपलोड की गई फ़ाइलों के लिए, file_ids. का उपयोग करें। कुल अनुलग्नक का आकार 25 MiB तक सीमित है।

send_at को एक समय क्षेत्र के साथ निर्दिष्ट किया जाता है, जिसे UTC में संग्रहीत किया जाता है; विलंबित शिपिंग एक वर्ष के भीतर उपलब्ध है। सीमाएँ वास्तविक भेजने पर जाँची जाती हैं, कतार निर्माण पर नहीं।