مرجع API

واجهة برمجية REST لإنشاء صناديق البريد وقراءة الرسائل برمجيًا.

العنوان الأساسي

https://www.newtempemail.site/api/v1

المصادقة

يحتاج كل طلب إلى مفتاح API في ترويسة Authorization، يُنشأ من صفحة مفاتيح API في حسابك. المفاتيح مرتبطة بحسابك ومحدودة المعدل حسب خطتك.

curl https://www.newtempemail.site/api/v1/inboxes \
  -H "Authorization: Bearer tm_live_xxxxxxxxxxxxxxxx"

احصل على مفتاح API

نقاط النهاية

GET/inboxesعرض صناديق بريدك

POST/inboxesإنشاء صندوق بريد جديد

GET/inboxes/{id}الحصول على تفاصيل صندوق البريد

DELETE/inboxes/{id}حذف صندوق بريد وكل رسائله

GET/inboxes/{id}/messagesعرض رسائل صندوق البريد

GET/inboxes/{id}/messages/{messageId}الحصول على رسالة واحدة (HTML/نص/ترويسات منظّفة)

DELETE/inboxes/{id}/messages/{messageId}حذف رسالة

GET/inboxes/{id}/messages/{messageId}/attachments/{attachmentId}الحصول على رابط تحميل موقّع قصير الأجل لمرفق

حدود معدل الطلبات

لكل خطة ميزانية طلبات معلنة لكل دقيقة، تُطبَّق على مستوى الحساب ومشتركة بين كل مفاتيحك — إنشاء مفاتيح إضافية لا يزيد ميزانيتك الإجمالية. راجع صفحة الأسعار للأرقام الدقيقة. تتضمن الاستجابات ترويسات حدود معدل قياسية.

الاتساق (Idempotency)

مرر ترويسة Idempotency-Key في طلبات POST لإعادة المحاولة بأمان دون إنشاء صندوق بريد مكرر.