Rasel Mailمرجع API إرسال الرسائل
الحقول والحدود والمصادقة وطلب متابعة الحالة.
آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦في هذا الدليل
العنوان والرؤوس
طلب الإرسال
POST https://raselmail.com/api/v1/delivery/messages
Authorization: Bearer YOUR_PROJECT_KEY
Idempotency-Key: order-123-confirmation
Content-Type: application/jsonالمفتاح خاص بمشروع واحد ودومينه. Idempotency-Key مطلوب، من 8 إلى 150 محرفًا مطبوعًا من ASCII؛ لا تستخدم بيانات شخصية ضمنه. حجم جسم الطلب الأقصى 750,000 بايت.
حقول JSON
| الحقل | مطلوب؟ | القاعدة |
|---|---|---|
| from | نعم | عنوان بريد من دومين المشروع، وليس اسم عرض. |
| to | نعم | مصفوفة فيها مستلم واحد على الأقل. |
| cc / bcc | اختياري | مصفوفات عناوين؛ لا تكرر عنوانًا بين القوائم. |
| subject | نعم | 1–998 محرفًا بعد إزالة المسافات الطرفية، بدون فواصل سطر. |
| text | text أو html | حتى 200,000 محرف؛ قدم نصًا بديلًا مع HTML إن أمكن. |
| html | text أو html | حتى 500,000 محرف؛ يجب وجود محتوى فعلي في أحد الحقلين. |
متابعة الحالة
طلب الحالة بنفس مفتاح المشروع
curl -i 'https://raselmail.com/api/v1/delivery/messages/YOUR_MESSAGE_ID' -H "Authorization: Bearer $RASEL_API_KEY"استبدل YOUR_MESSAGE_ID بالمعرّف الذي أعاده الإرسال. الاستجابة تحتوي id وstate وrecipient_count وerror إن وجد وcreated_at وupdated_at. لا يمكنك قراءة حالة رسالة تخص مشروعًا آخر.
حدود الطلبات
إنشاء الرسائل: 120 طلبًا في الدقيقة للمشروع و300 لحساب المالك. قراءة الحالة: 300 طلب في الدقيقة للمشروع. هذه حدود طلبات، وليست رصيد الإرسال المشترى. عند 429 انتظر قبل المحاولة، واحتفظ بنفس مفتاح منع التكرار للحدث نفسه.