وثائق واجهة الإرسال
واجهة واحدة لإرسال رسائل التسجيل واستعادة كلمة المرور والإشعارات من موقعك — دون SMTP.
متاح الآن يُتحقّق من الملكية وMX وSPF وDKIM وDMARC كلٌّ على حدة. وبعد الجاهزية أرسل بمفتاح API وتابع في اللوحة النتائج لكل مستلم: مُسلَّم وفاشل وقيد المعالجة.
بداية سريعة
- 1
اربط نطاقًا
أضف نطاق الإرسال في «إرسال للمواقع».
- 2
تحقّق من DNS
أضف سجلات SPF / DKIM / DMARC وسجل TXT للتحقق ثم تحقّق بنقرة.
- 3
أنشئ مفتاحًا
أنشئ مفتاح te_live_ — يُعرض النص مرة واحدة فقط، فاحفظه فورًا.
إرسال بريد
طلب POST مع مفتاح te_live_ في ترويسة Authorization.
curl -X POST https://tutuemail.com/api/sending/send \
-H "Authorization: Bearer te_live_xxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: signup-user-123" \
-H "Content-Type: application/json" \
-d '{
"from": "noreply@your-domain.com",
"to": "user@example.com",
"subject": "欢迎注册",
"html": "<p>点击验证你的邮箱</p>"
}'حقول الطلب
from عنوان المرسل، يجب أن يكون ضمن نطاق مُتحقّق منهto عنوان المستلم (مفرد أو مصفوفة)subject موضوع البريدhtml / text نص البريد (HTML أو نص عادي)Idempotency-Key ترويسة اختيارية؛ استخدم القيمة نفسها عند إعادة المحاولة لتفادي الإرسال المكرريعيد الطلب المقبول HTTP 202 مع id وحالة accepted. وبالمفتاح نفسه، يعيد GET /api/sending/messages/{id} لكل مستلم: مُسلَّم أو فاشل أو قيد المعالجة أو غير معروف.
الأخطاء والحدود
401 مفتاح غير صالح أو مُلغى — أنشئ مفتاح te_live_ من جديد403 نطاق المرسل غير مُتحقّق، أو العنوان ليس ضمن نطاق مُتحقّق429 تجاوز معدل الإرسال؛ يتضمّن الرد retry_after — أعد المحاولة لاحقًا حسب الإرشاد503 محرّك البريد غير متاح مؤقتًا؛ أعد المحاولة بنفس Idempotency-Keyلعدد المستلمين وحجم النص والمعدل حدود حماية. ولا يُحتسب الاستخدام إلا بعد التحقق، فلا تستنزف الطلبات غير الصالحة حصتك.