REST API

أرسل بطلب JSON واحد. مفاتيح عدم التكرار تمنع التسليم المكرر.

الموارد الأساسية

POST /v1/emails — إدراج رسالة في قائمة الانتظار GET /v1/emails/{id} — فحص حالة الرسالة

نموذج الاستجابة

الرمز 202 يعني أن الرسالة أُدرجت في قائمة الانتظار وليس أنها وصلت إلى صندوق الوارد. الرمز 403 قد يشير إلى نطاق صلاحية مفقود أو نطاق غير مُتحقَّق منه. الرمز 422 يحجب مستلمًا موقوفًا. الرمز 429 يشير إلى تجاوز حد المعدل.

نموذج الوصول الحالي

تستخدم المفاتيح الحالية srs_live_. قبل التحقق من نطاق From لا يرسل مرسل sandbox المشترك إلا إلى أعضاء المشروع. بعد ذلك تطبق الحصص وقائمة suppression وحدود المستلمين وضوابط إساءة الاستخدام. تعني 202 وضع الرسالة في الطابور لا تسليمها.

موارد التكامل

استخدم الدليل العملي للبشر ووكلاء الذكاء الاصطناعي، واعتبر OpenAPI مصدر الحقيقة للحقول.

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