प्रमाणीकरण
डैशबोर्ड से जारी scoped srs_live_ key को Bearer token के रूप में भेजें। हर key के अपने scope होते हैं (emails:send, webhooks:write …); निरस्त या समाप्त keys 401 के साथ अस्वीकार होती हैं।
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>"
}मुख्य संसाधन
- POST /v1/emails — एक संदेश कतार में डालें
- POST /v1/emails/batch — एक अनुरोध में 100 तक संदेश
- GET /v1/emails — हाल के संदेशों की सूची
- GET /v1/emails/{id} — संदेश की स्थिति
- DELETE /v1/emails/{id}/schedule — निर्धारित प्रेषण रद्द करें
प्रतिक्रिया मॉडल
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 स्वीकार्यता डिलीवरी या इनबॉक्स की गारंटी नहीं देती।