REST API

एक JSON अनुरोध से भेजें।

मुख्य संसाधन

POST /v1/emails — एक संदेश कतार में डालें GET /v1/emails/{id} — संदेश की स्थिति देखें

प्रतिक्रिया मॉडल

202 का अर्थ है कतार में डाला गया, इनबॉक्स में नहीं। 403 अनुपस्थित scope या असत्यापित डोमेन को इंगित कर सकता है। 422 suppressed प्राप्तकर्ता को ब्लॉक करता है। 429 rate limiting को इंगित करता है।

सेवा की वर्तमान सीमाएँ

REST API अटैचमेंट अस्वीकार करती है। केवल In-Reply-To, References, List-Unsubscribe और List-Unsubscribe-Post कस्टम हेडर स्वीकार हैं (अधिकतम 8)। होस्ट किया मेल अलग है: वेब में 20 अटैचमेंट और कुल 25 MiB; जारी डेस्कटॉप क्लाइंट में भेजने की सीमा 10 MiB है। HTTP 202 और email.accepted का मतलब प्रसंस्करण के लिए स्वीकार होना है; SMTP स्वीकार्यता डिलीवरी या इनबॉक्स की गारंटी नहीं देती।

वर्तमान access model

वर्तमान keys srs_live_ उपयोग करती हैं। From domain verify होने से पहले shared sandbox sender केवल project members को भेज सकता है। उसके बाद plan quota, suppression, recipient throttling और abuse controls लागू रहते हैं। 202 का अर्थ queued है, delivered नहीं।

POST /v1/emails

POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json

{
  "from": "Sender Name <info@example.com>",
  "to": ["user@example.net"],
  "subject": "Reset your password",
  "html": "<p>Click to reset your password.</p>"
}