REST API

REST API

একটি JSON অনুরোধে পাঠান।

মূল রিসোর্স

POST /v1/emails — একটি বার্তা queue করুন GET /v1/emails/{id} — বার্তার অবস্থা পরীক্ষা করুন

রেসপন্স মডেল

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 গ্রহণ ডেলিভারি বা ইনবক্সের নিশ্চয়তা নয়।

বর্তমান access model

বর্তমান key srs_live_ ব্যবহার করে। From domain যাচাইয়ের আগে shared sandbox sender শুধু project member-কে পাঠাতে পারে। এরপর plan quota, suppression, recipient throttling ও abuse control প্রযোজ্য। 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>"
}