REST API

एक JSON अनुरोध से भेजें। आइडेम्पोटेंसी कुंजियाँ डुप्लिकेट डिलीवरी रोकती हैं।

मुख्य संसाधन

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

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

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

वर्तमान access model

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

इंटीग्रेशन संसाधन

मनुष्यों और AI agents के लिए step-by-step guide उपयोग करें; fields के लिए OpenAPI source of truth है।

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>"
}