প্রমাণীকরণ
ড্যাশবোর্ড থেকে ইস্যু করা scoped srs_live_ কী Bearer টোকেন হিসেবে পাঠান। প্রতিটি কী-র নিজস্ব scope আছে (emails:send, webhooks:write …); বাতিল বা মেয়াদোত্তীর্ণ কী 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 — একটি বার্তা queue করুন
- POST /v1/emails/batch — এক অনুরোধে সর্বোচ্চ 100 বার্তা
- GET /v1/emails — সাম্প্রতিক বার্তার তালিকা
- GET /v1/emails/{id} — বার্তার অবস্থা
- DELETE /v1/emails/{id}/schedule — নির্ধারিত প্রেরণ বাতিল
রেসপন্স মডেল
202 মানে queue করা হয়েছে, ইনবক্সে পৌঁছায়নি। 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 গ্রহণ ডেলিভারি বা ইনবক্সের নিশ্চয়তা নয়।