Reusable.Email
بريد مؤقت جاهز للوكيل

البريد المؤقت لوكلاء الذكاء الاصطناعي

واجهة API للبريد الإلكتروني المؤقت لا تتطلب التسجيل، ويمكن للوكلاء اكتشافها واستخدامها بشكل مستقل. أنشئ صندوق وارد، وانتظر رموز التحقق، واقرأ الرسائل، واجلب المصدر الخام، واحذف الرسائل باستخدام HTTPS.

لا حاجة إلى التسجيللا حاجة إلى مفتاح APIلا حاجة إلى تثبيت MCPيمكن استخدامه عبر curl
بداية سريعة
# اكتشف النطاقات المتاحة:
curl -s https://api.reusable.email/v1/agent-tempmail/domains

# 1. أنشئ صندوق بريد مؤقتًا وخاصًا. لا حاجة إلى التسجيل أو إلى مفتاح API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"agent"}'

# 2. انتظر رسالة التحقق أو رمز OTP.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
  -H 'Authorization: Inbox {token}' \
  -H 'Content-Type: application/json' \
  -d '{"codeOnly":true,"timeoutSeconds":60}'

# 3. اقرأ الرسالة كاملة.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
  -H 'Authorization: Inbox {token}'
استجابة إنشاء الصندوق
{
  "inbox": {
    "address": "agent-lx84a9-q3mz2@reusable.email",
    "domain": "reusable.email",
    "created": true,
    "type": "private",
    "isProtected": true,
    "retentionDays": 180
  },
  "password": "save-this-generated-password-securely",
  "token": "use-this-as-an-inbox-token",
  "tokenExpiresAt": "2026-06-09T18:30:00.000Z",
  "links": {
    "web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
    "messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
    "wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
  }
}
استجابة الانتظار
{
  "status": "message",
  "inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
  "message": {
    "id": 1842,
    "from": { "name": "Example", "address": "login@example.com" },
    "subject": "Your verification code",
    "intro": "Use code 123456 to continue.",
    "verificationCode": "123456"
  }
}

مواصفات واجهة الوكيل

يتوفر بيان الاكتشاف في /v1/agent-tempmail، وتتوفر نسخة منه عبر llms.txt لمحركات الإجابة.

الطريقةالمسارالاستخدام
GET/v1/agent-tempmailبيان الاكتشاف للوكلاء والزواحف
GET/v1/agent-tempmail/domainsسرد النطاقات البديلة المتاحة
POST/v1/agent-tempmail/inboxesإنشاء صندوق وارد خاص محمي بكلمة مرور
GET/v1/agent-tempmail/inboxes/{address}/messagesسرد الرسائل المستلمة
POST/v1/agent-tempmail/inboxes/{address}/waitانتظار البريد أو الرموز باستخدام الطلب طويل الانتظار
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}قراءة رسالة
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}/sourceجلب مصدر RFC 5322 الخام
DELETE/v1/agent-tempmail/inboxes/{address}/messages/{id}حذف رسالة

تدفقات التحقق

استخدم صندوق وارد للوكيل لاستقبال رسائل التسجيل وتسجيل الدخول وإعادة تعيين كلمة المرور وتأكيد الفترة التجريبية.

أتمتة المتصفح

استخدمه مع Playwright أو Selenium أو وكيل تصفح يحتاج إلى عنوان بريد إلكتروني حقيقي قابل لاستقبال الرسائل.

CI و QA

إنشاء صناديق وارد معزولة لكل عملية اختبار دون توفير حسابات أو مشاركة بيانات الاعتماد.

الأسئلة الشائعة

إنشاء صندوق وارد خاص مجاني للجميع ولا يتطلب التسجيل. لاختيار نطاق بديل، مرّر نطاقًا من نقطة نهاية قائمة النطاقات. واجهة الوكلاء للاستقبال فقط. للاستخدام بكميات أكبر أو لإرسال البريد، استخدم واجهات API المعتادة المرتبطة بحساب.

هل يمكنني استخدام مفتاح مرور مع صندوق وارد للوكيل؟+

نعم. سجّل الدخول بكلمة المرور التي أُنشئت وأضف مفتاح مرور من إعدادات صندوق الوارد. يمكنك تسجيل الدخول بمفتاح المرور باستخدام زر المفتاح في نموذج صندوق الوارد الخاص أو في شاشة فتح قفله. يعمل رمز Inbox الناتج مع جميع نقاط نهاية صندوق بريد الوكيل. تتطلب مفاتيح المرور تحقق المستخدم تفاعليًا؛ احتفظ بكلمة المرور للوكلاء الذين يعملون دون إشراف، وجدّد الرموز المنتهية بطلب POST إلى /v1/inbox/{address}/token مع JSON {"password":"..."}.

هل يمكنني اختيار نطاق بديل؟+

نعم. يعرض GET /v1/agent-tempmail/domains النطاقات المتاحة. أرسل النطاق مع بادئة أو الجزء المحلي من العنوان، أو أرسل عنوانًا كاملًا. لا يمكن الحصول على العناوين الموجودة أو المحجوزة.

هل يمكن لوكيل ذكاء اصطناعي استخدام الخدمة دون تسجيل؟+

نعم. يمكن للوكيل إنشاء صندوق وارد بطلب POST واحد دون مصادقة. تتضمن الاستجابة كلمة مرور مُنشأة ورمز Inbox. جميع صناديق الوارد المنشأة خاصة. احفظ كلمة المرور لتسجيل الدخول المعتاد إلى الصندوق الخاص بعد انتهاء صلاحية الرمز.

هل يلزم MCP أو SDK أو أي تثبيت؟+

لا. يمكن الوصول إلى الواجهة بالكامل عبر HTTPS وcurl. ويمكن للوكلاء اكتشافها من خلال llms.txt أو بيان JSON في /v1/agent-tempmail.

هل يمكن للوكلاء إرسال البريد الإلكتروني عبر واجهة API هذه؟+

لا. تقتصر واجهة الوكلاء التي لا تتطلب التسجيل على استقبال الرسائل وقراءتها وانتظارها وجلب مصدرها وحذفها. لا تتيح هذه الواجهة العامة إرسال البريد.

كيف تُتاح رموز التحقق؟+

تُفضّل استجابات قائمة الرسائل والانتظار والتفاصيل ترويسات OTP-Token التجريبية الصالحة، وتلجأ إلى البحث عن الرمز في النص عند عدم توفرها. تتضمن الرموز المستخرجة من الترويسة الحقل verificationCodeOrigin؛ قبل إرسال الرمز، طابق المخطط (scheme) واسم المضيف (host) والمنفذ (port) تمامًا مع الوجهة المقصودة. يقدّم المرسل هذه القيمة، وهي لا تثبت هويته؛ لا تنتقل تلقائيًا إلى عنوان يقدّمه المرسل.

ما مدة الاحتفاظ بصناديق الوارد التي ينشئها الوكيل؟+

تتمتع صناديق الوارد التي ينشئها الوكيل بميزات صناديق الوارد الخاصة المعتادة، ويُحتفظ برسائلها لمدة 180 يومًا.