भेजने का API दस्तावेज़
एक API से अपनी साइट के साइनअप, पासवर्ड-रीसेट व सूचना ईमेल भेजें — कोई SMTP नहीं।
अभी उपलब्ध स्वामित्व, MX, SPF, DKIM और DMARC अलग-अलग सत्यापित होते हैं। तैयार होने पर API कुंजी से भेजें और डैशबोर्ड में प्रति-प्राप्तकर्ता सफल/विफल/प्रक्रियाधीन देखें।
त्वरित आरंभ
- 1
डोमेन जोड़ें
«वेबसाइट भेजना» में अपना भेजने-डोमेन जोड़ें।
- 2
DNS सत्यापित करें
SPF / DKIM / DMARC व सत्यापन TXT रिकॉर्ड जोड़ें, फिर एक क्लिक में सत्यापित करें।
- 3
कुंजी बनाएं
te_live_ कुंजी बनाएं — सादा टेक्स्ट सिर्फ़ एक बार दिखता है, तभी सहेजें।
ईमेल भेजें
Authorization हेडर में te_live_ कुंजी के साथ POST अनुरोध।
curl -X POST https://tutuemail.com/api/sending/send \
-H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: signup-user-123" \
-H "Content-Type: application/json" \
-d '{
"from": "noreply@your-domain.com",
"to": "user@example.com",
"subject": "欢迎注册",
"html": "<p>点击验证你的邮箱</p>"
}'अनुरोध फ़ील्ड
from प्रेषक पता, सत्यापित डोमेन के अंतर्गत होना चाहिएto प्राप्तकर्ता पता (एकल या array)subject ईमेल विषयhtml / text ईमेल बॉडी (HTML या सादा टेक्स्ट)Idempotency-Key वैकल्पिक हेडर; पुनःप्रयास पर वही मान उपयोग करें ताकि दोहरा भेजाव न होस्वीकृत अनुरोध HTTP 202, request id व accepted स्थिति देता है। उसी API कुंजी से GET /api/sending/messages/{id} प्रति-प्राप्तकर्ता वितरित/विफल/लंबित/अज्ञात लौटाता है।
त्रुटियाँ व सीमाएँ
401 कुंजी अमान्य या रद्द — te_live_ कुंजी पुनः बनाएं403 प्रेषक डोमेन असत्यापित, या पता सत्यापित डोमेन के अंतर्गत नहीं429 भेजने की दर पार; प्रतिक्रिया में retry_after — निर्देशानुसार बाद में पुनःप्रयास503 मेल इंजन अस्थायी रूप से अनुपलब्ध; उसी Idempotency-Key से पुनःप्रयासप्राप्तकर्ता संख्या, बॉडी आकार व दर की सुरक्षा सीमाएँ हैं। उपयोग सत्यापन के बाद ही गिना जाता है, अतः अमान्य अनुरोध आपका कोटा खर्च नहीं करते।