Tmailor Open API

واجهة برمجة تطبيقات البريد المؤقت للاختبار والأتمتة

أنشئ من كودك عناوين بريد مؤقتة للاستقبال فقط، واقرأ الرسائل الواردة بصيغة JSON. يبقى كل عنوان في حسابك على Tmailor حتى تحذفه، وتعيد واجهة برمجة التطبيقات الرمز لمرة واحدة الذي تجده في الرسالة.

آخر تحديث: October 2026

ابدأ مجانًا اقرأ مستندات API

عرض الخطط والحدود

REST وJSON
SDKs وCLI وخادم MCP
100 صندوق بريد مجاني شهريًا
استقبال فقط، رسائل لمدة 24 ساعة

export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

# pip install tmailor-sdk
from tmailor import Client

with Client() as client:  # reads TMAILOR_API_KEY
    box = client.mailboxes.create()
    print(box.email)

    # trigger the email, then wait for it
    msg = box.wait_for_message(
        timeout=120, since=(box.created_at or 0) - 1)
    print(msg.subject, msg.otp(), msg.links())

// npm install tmailor
import { Client } from "tmailor";

const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);

// trigger the email, then wait for it
const msg = await box.waitForMessage({
  timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);

<?php // composer require tmailor/tmailor
use Tmailor\Client;

$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";

// trigger the email, then wait for it
$msg = $box->waitForMessage(
    timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp;

أنشئ عنوانًا، وانتظر البريد الإلكتروني، ثم اقرأ الرمز.

ادفع مقابل كل صندوق بريد، لا مقابل كل طلب

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

مثال: اختبار OTP ينشئ عنوانًا واحدًا ويتحقق من صندوق الوارد 25 مرة يستهلك صندوق بريد واحد.

من مفتاح API إلى صندوق الوارد في أربع خطوات

أنشئ مفتاح API
سجّل الدخول إلى منصة API باستخدام حسابك في tmailor.com أو بحساب Google وأنشئ مفتاحًا. وفي الخطة المجانية، أضف أيضًا عنوان IP واحدًا للخادم الذي سيستدعي API.
أنشئ عنوانًا
أرسل طلبًا واحدًا للحصول على عنوان عشوائي على نطاق مشترك، أو اختر اسمًا مخصصًا على نطاق تملكه وتحققت منه.
اقرأ الرسائل
اعرض صندوق الوارد واقرأ كل رسالة بصيغة JSON: المرسل، والموضوع، والنص، وHTML المنقّى، ورمز الاستخدام لمرة واحدة والروابط التي وجدها API.
احتفظ به أو احذفه
العناوين لا تنتهي صلاحيتها. افتح صندوق الوارد نفسه على tmailor.com عبر رابط إعادة الاستخدام، أو احذف العنوان عند الانتهاء من اختبارك.

مصمَّم لسير عمل بريدي قابل للتكرار

امنح كل عملية اختبار صندوق بريد خاصًا بها بدلًا من مشاركة صندوق بريد حقيقي واحد.

اختبارات التسجيل وOTP

أنشئ عنوانًا جديدًا لكل تسجيل أو إعادة تعيين كلمة مرور أو فحص رمز لمرة واحدة، ثم اقرأ الرمز من الاستجابة.

خطوط أنابيب CI/CD

نفّذ فحوصات بريد إلكتروني شاملة من البداية إلى النهاية في خط أنابيبك باستخدام المفتاح في متغير بيئة. تقبل الخطط المدفوعة الطلبات من أي عنوان IP.

ضمان الجودة والبيئات التجريبية

امنح المختبِرين وبيئات الاختبار التجريبية عناوين خاصة بهم وأبعِد صناديق البريد الحقيقية عن بيانات الاختبار.

عناوين على نطاقك الخاص

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

الخطط والأسعار

اختر عدد صناديق البريد التي تحتاجها. تتجدد حصتك كل 30 يومًا، حتى في الخطط السنوية.

مجاني

جرّب API وشغّل مشاريع صغيرة.

$0 /شهر

100 صندوق بريد كل 30 يومًا
حتى 30 طلب في الدقيقة
2,000 طلب يوميًا
الطلبات من عنوان IP واحد مسموح به
نطاقات مشتركة ونطاقاتك الخاصة

ابدأ مجانًا

Starter

لمطور واحد أو مجموعة اختبارات صغيرة.

$9 /شهر

3,000 صندوق بريد كل 30 يومًا
حتى 300 طلب في الدقيقة
بلا حصة طلبات يومية أو شهرية
الطلبات من أي عنوان IP
نطاقات مشتركة ونطاقاتك الخاصة

اختر Starter

Pro

للفرق التي تشغّل الاختبارات يوميًا.

$29 /شهر

30,000 صندوق بريد كل 30 يومًا
حتى 600 طلب في الدقيقة
بلا حصة طلبات يومية أو شهرية
الطلبات من أي عنوان IP
نطاقات مشتركة ونطاقاتك الخاصة

اختر Pro

Business

للشركات ذات الأتمتة اليومية المكثفة.

$99 /شهر

150,000 صندوق بريد كل 30 يومًا
حتى 2,000 طلب في الدقيقة
بلا حصة طلبات يومية أو شهرية
الطلبات من أي عنوان IP
نطاقات مشتركة ونطاقاتك الخاصة

اختر Business

Scale

لأساطيل الاختبارات الكبيرة وخطوط الأنابيب المزدحمة.

$199 /شهر

400,000 صندوق بريد كل 30 يومًا
حتى 4,000 طلب في الدقيقة
بلا حصة طلبات يومية أو شهرية
الطلبات من أي عنوان IP
نطاقات مشتركة ونطاقاتك الخاصة

اختر Scale

Enterprise

لأعلى حجم صناديق بريد وأعلى معدل طلبات.

$499 /شهر

2,000,000 صندوق بريد كل 30 يومًا
حتى 6,000 طلب في الدقيقة
بلا حصة طلبات يومية أو شهرية
الطلبات من أي عنوان IP
نطاقات مشتركة ونطاقاتك الخاصة

اختر Enterprise

قارن بين الخطط

تختلف هذه الحدود من خطة إلى أخرى، أما كل ما عداها فهو نفسه في جميع الخطط.

قارن بين الخطط
الخطة	مجاني	Starter	Pro	Business	Scale	Enterprise
السعر الشهري	$0	$9	$29	$99	$199	$499
السعر السنوي	$0	$90	$290	$990	$1,990	$4,990
صناديق البريد كل 30 يومًا	100	3,000	30,000	150,000	400,000	2,000,000
الطلبات في الدقيقة	30	300	600	2,000	4,000	6,000
الحد اليومي للطلبات	2,000	بلا حد	بلا حد	بلا حد	بلا حد	بلا حد
قائمة IP المسموح بها	مطلوبة، IP واحد	غير مطلوبة	غير مطلوبة	غير مطلوبة	غير مطلوبة	غير مطلوبة
خادم MCP المستضاف	الخادم المحلي فقط	متاح	متاح	متاح	متاح	متاح

اسحب جانبيًا لمقارنة جميع الخطط.

متاح في كل خطة

واجهة REST API بردود JSON
عناوين عشوائية على نطاقات مشتركة
أسماء مخصصة على نطاقاتك الموثّقة
نطاقاتك الخاصة بلا حدود (يمكن انتظار التحقق لما يصل إلى 3 نطاقات في الوقت نفسه)
عناوين لا تنتهي صلاحيتها
لا حد لعدد العناوين التي تحتفظ بها
تُحفظ الرسائل لمدة 24 ساعة
استخراج رمز التحقق والروابط (بأفضل جهد)
رابط إعادة الاستخدام لفتح صندوق الوارد على tmailor.com
حزم SDK رسمية وأداة سطر أوامر
يمكن الجمع بين الخطط وتُجمع حدودها
استلام فقط، دون مرفقات
حذف العنوان لا يعيد الحصة

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

مجموعات SDK الرسمية وواجهة سطر الأوامر

استدعِ API من لغتك المفضلة باستخدام نماذج محددة الأنواع، وإعادة محاولة تلقائية، ومساعد ينتظر الرسالة التالية. تتبع كل مجموعة SDK نفس الـ API وسيناريوهات الاختبار المشتركة.

Python

متوفر

Python 3.9+

pip install tmailor-sdk

يتضمن tmailor سطر الأوامر.

عرض على PyPI المصدر على GitHub

Node.js

متوفر

Node.js 18+, TypeScript types

npm install tmailor

عرض على npm المصدر على GitHub

PHP

متوفر

PHP 8.1+

composer require tmailor/tmailor

عرض على Packagist المصدر على GitHub

لوكلاء الذكاء الاصطناعي

خادم MCP لوكلاء الذكاء الاصطناعي

دع Claude وCursor وVS Code Copilot وغيرها من عملاء MCP يختبرون تدفقات التسجيل التي تملكها أو يُسمح لك باختبارها: ينشئ الوكيل عنوانًا حقيقيًا للاستقبال فقط، وينتظر وصول البريد الإلكتروني ويقرأ رمز المرة الواحدة أو رابط التحقق.

يمنح كلا الخيارين الوكيل الأدوات نفسها: إنشاء عنوان، وانتظار البريد الإلكتروني والحصول على رمز المرة الواحدة وروابطه، وقراءة الرسائل، وحذف العناوين، والتحقق من حصتك. لا يرى الوكيل سوى عناوين البريد الإلكتروني، ولا يرى أبدًا الـ token خلفها، ويستهلك حصة صندوق البريد وحد المعدل نفسيهما المخصصين لـ API.

الخادم المستضاف

لا حاجة إلى تثبيت

https://mcp.tmailor.com/mcp

أضف رابط الخادم إلى تطبيق الذكاء الاصطناعي لديك. التطبيقات التي تدعم تسجيل الدخول، مثل Claude وChatGPT وCodex، تنقلك إلى منصة Tmailor للموافقة على الوصول. أما العملاء الآخرون فيرسلون مفتاح API الخاص بك في ترويسة Authorization.

يتطلب خطة مدفوعة نشطة. تأتي الطلبات من خادمنا، لذا لا تحتاج إلى قائمة عناوين IP المسموح بها.

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

اطّلع على التطبيقات المتصلة في صفحة اتصالات الذكاء الاصطناعي وافصل أيًا منها. يفقد التطبيق المفصول الوصول خلال 30 ثانية.

عرض الخطط والحدود

الخادم المحلي

جميع الخطط، بما فيها المجانية

tmailor-mcp

يعمل على جهازك، ويقرأ مفتاحك من TMAILOR_API_KEY ويحتاج إلى uv أو Python 3.10+. في الخطة المجانية، أضف عنوان IP الخاص بذلك الجهاز إلى قائمة السماح.

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

عرض على PyPI الإعداد لكل عميل MCP

جرّب أن تسأل: "أنشئ بريدًا مؤقتًا، وسجّل به في موقع الاختبار الخاص بي وأخبرني برمز التحقق."

الأسئلة الشائعة حول واجهة برمجة تطبيقات البريد المؤقت

ما الذي يُحتسب صندوق بريد؟

كل عنوان جديد تنشئه يستهلك صندوق بريد واحد من حصة الدورة الحالية البالغة 30 يومًا. لا يستهلك العرض والقراءة والحذف أي صناديق بريد، وحذف العنوان لا يعيد صندوق البريد.

هل تنتهي صلاحية العناوين؟

لا. يبقى العنوان في حسابك حتى تحذفه. وتُحفظ الرسائل داخله لمدة 24 ساعة.

هل يمكنني إرسال بريد إلكتروني أو استلام المرفقات؟

لا. واجهة برمجة التطبيقات (API) للاستقبال فقط، ولا تُسلَّم المرفقات.

هل يمكنني اختيار اسم العنوان والنطاق؟

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

هل أحتاج إلى قائمة IP مسموح بها؟

في الخطة المجانية فقط، حيث تضيف عنوان IP واحدًا يتصل منه خادمك. لا يمكن أن ينتمي عنوان IP إلا إلى حساب مجاني واحد، لذا قد يكون عنوان مكتب مشترك أو VPN مستخدمًا بالفعل. مع خطة مدفوعة نشطة، تقبل واجهة برمجة التطبيقات الطلبات من أي عنوان IP.

هل تقرأ واجهة برمجة التطبيقات (API) رمز التحقق نيابة عني؟

نعم، على أساس أفضل جهد. عند قراءة رسالة، يتضمن الرد الرمز لمرة واحدة الذي وجده (أو null عندما لا يكون متأكدًا)، وقيمًا أخرى شبيهة بالرموز، والروابط. تحقق دائمًا من القيمة في اختبارك.

هل يمكن لوكلاء الذكاء الاصطناعي مثل Claude أو ChatGPT استخدام واجهة برمجة التطبيقات (API)؟

نعم، عبر MCP. في الخطة المدفوعة، أضف الخادم المستضاف https://mcp.tmailor.com/mcp إلى تطبيق الذكاء الاصطناعي لديك ووافق على الوصول، أو أرسل مفتاح API الخاص بك. وفي أي خطة، يمكنك تشغيل خادم tmailor-mcp مفتوح المصدر على جهازك. في كلتا الحالتين، يستطيع الوكيل إنشاء عنوان وانتظار البريد الإلكتروني وقراءة الرمز لمرة واحدة، مستخدمًا حصة صناديق البريد نفسها الخاصة بواجهة برمجة التطبيقات (API).

هل هناك حد للطلبات في الخطط المدفوعة؟

لا تفرض الخطط المدفوعة حصة طلبات يومية أو شهرية، لكن لكل خطة حد معدل لكل دقيقة. كما تفرض الخطة المجانية حدًا أقصى للطلبات اليومية.

هل أحتاج إلى بطاقة ائتمان للبدء؟

لا. سجّل الدخول بحسابك على tmailor.com أو بحساب Google، وأنشئ مفتاحًا وابدأ بالخطة المجانية. لا تدفع إلا عند اختيارك خطة مدفوعة.

كيف يمكنني الدفع مقابل الخطة؟

ادفع باستخدام USDT على شبكة TRC20 (Tron) أو BEP20 (BNB Smart Chain)، أو عبر Binance Pay. لا تُقبل بطاقات الائتمان والخصم. تصبح خطتك نشطة عند تأكيد الدفع، عادةً خلال بضع دقائق.

هل يمكنني استرداد المبلغ؟

لا. المدفوعات غير قابلة للاسترداد، لذا اختبر تكاملك في الخطة المجانية قبل الترقية.

ما الاستخدامات غير المسموح بها لواجهة برمجة التطبيقات (API)؟

الرسائل المزعجة والاحتيال وإنشاء حسابات بالجملة على خدمات أخرى والتهرب من حظرها أو قيودها كلها تنتهك شروط واجهة برمجة التطبيقات (API). قد نلغي مفاتيح API للحسابات التي تفعل ذلك ونقفلها.

أنشئ عنوانك الأول في دقائق

ابدأ بالخطة المجانية مع 100 صندوق بريد شهريًا. لا حاجة إلى بطاقة ائتمان.

ابدأ مجانًا اقرأ مستندات API

واجهة برمجة تطبيقات البريد المؤقت للاختبار والأتمتة

ادفع مقابل كل صندوق بريد، لا مقابل كل طلب

من مفتاح API إلى صندوق الوارد في أربع خطوات

أنشئ مفتاح API

أنشئ عنوانًا

اقرأ الرسائل

احتفظ به أو احذفه

مصمَّم لسير عمل بريدي قابل للتكرار

اختبارات التسجيل وOTP

خطوط أنابيب CI/CD

ضمان الجودة والبيئات التجريبية

عناوين على نطاقك الخاص

الخطط والأسعار

مجاني

Starter

Pro

Business

Scale

Enterprise

قارن بين الخطط

متاح في كل خطة

مجموعات SDK الرسمية وواجهة سطر الأوامر

Python

Node.js

PHP

خادم MCP لوكلاء الذكاء الاصطناعي

الخادم المستضاف

الخادم المحلي

الأسئلة الشائعة حول واجهة برمجة تطبيقات البريد المؤقت

أنشئ عنوانك الأول في دقائق