API باز Tmailor

API ایمیل موقت برای تست و اتوماسیون

Q: چه چیزی یک صندوق پستی محسوب میشود؟

هر آدرس جدیدی که ایجاد میکنید، یک صندوق پستی از سهمیه چرخه ۳۰ روزه فعلی مصرف میکند. فهرست کردن، خواندن و حذف، صندوق پستی مصرف نمیکنند و حذف یک آدرس، صندوق پستی را برنمیگرداند.

Q: آیا آدرسها منقضی میشوند؟

خیر. آدرس تا زمانی که آن را حذف نکنید در حساب شما باقی میماند. پیامهای داخل آن به مدت ۲۴ ساعت نگهداری میشوند.

Q: آیا میتوانم ایمیل بفرستم یا پیوست دریافت کنم؟

خیر. API فقط دریافت میکند و پیوستها تحویل داده نمیشوند.

Q: آیا میتوانم نام و دامنه آدرس را انتخاب کنم؟

در دامنههای مشترک ما، نام تصادفی است. برای انتخاب نام، دامنهای را که مالک آن هستید در پلتفرم API اضافه و با تنظیم رکورد MX آن به سمت ما تأیید کنید، سپس آدرسهایی با نام سفارشی که از قوانین نامگذاری پیروی میکند ایجاد کنید.

Q: آیا به فهرست مجاز IP نیاز دارم؟

فقط در طرح رایگان، که در آن تنها آدرس IPای را که سرور شما از آن درخواست میفرستد اضافه میکنید. هر آدرس IP فقط میتواند به یک حساب رایگان تعلق داشته باشد، بنابراین ممکن است آدرس مشترک یک دفتر یا VPN از قبل در حال استفاده باشد. با یک طرح پولی فعال، API درخواستها را از هر آدرس IP میپذیرد.

Q: آیا API کد تأیید را برای من میخواند؟

بله، به صورت تلاش حداکثری. وقتی پیامی را میخوانید، پاسخ شامل کد یکبارمصرفی است که یافته (یا null وقتی مطمئن نیست)، سایر مقادیر شبیه کد و لینکها. همیشه مقدار را در تست خود بررسی کنید.

Q: آیا عاملهای هوش مصنوعی مانند Claude یا ChatGPT میتوانند از API استفاده کنند؟

بله، از طریق MCP. در طرح پولی، سرور میزبانیشده https://mcp.tmailor.com/mcp را به اپ هوش مصنوعی خود اضافه کنید و دسترسی را تأیید کنید، یا کلید API خود را ارسال کنید. در هر طرحی میتوانید سرور متنباز tmailor-mcp را روی کامپیوتر خودتان اجرا کنید. در هر دو حالت، عامل میتواند یک آدرس بسازد، منتظر ایمیل بماند و کد یکبارمصرف را بخواند و از همان سهمیه صندوق پستی API استفاده میکند.

Q: آیا طرحهای پولی محدودیت درخواست دارند؟

طرحهای پولی سهمیه درخواست روزانه یا ماهانه ندارند، اما هر طرح محدودیت نرخ در دقیقه دارد. طرح رایگان نیز سقف درخواست روزانه دارد.

از کد خود آدرس‌های ایمیل موقت فقط دریافت‌کننده بسازید و پیام‌های ورودی را به صورت JSON بخوانید. هر آدرس تا زمانی که آن را حذف نکنید در حساب Tmailor شما باقی می‌ماند و API کد یک‌بارمصرفی را که در پیام پیدا می‌کند بازمی‌گرداند.

آخرین به‌روزرسانی: October 2026

شروع رایگان مستندات API را بخوانید

مشاهده پلن‌ها و محدودیت‌ها

REST و JSON
SDKها، CLI و سرور MCP
100 صندوق پستی رایگان در ماه
فقط دریافت، پیامها به مدت ۲۴ ساعت

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 که یک آدرس ایجاد می‌کند و صندوق ورودی را ۲۵ بار بررسی می‌کند، فقط یک صندوق پستی مصرف می‌کند.

از کلید API تا صندوق ورودی در چهار مرحله

یک کلید API بسازید
با حساب tmailor.com یا Google وارد پلتفرم API شوید و یک کلید بسازید. در طرح رایگان، همچنین تنها آدرس IP سروری را که API را فراخوانی می‌کند اضافه کنید.
یک آدرس بسازید
با یک درخواست، یک آدرس تصادفی روی یک دامنه مشترک دریافت کنید، یا نامی دلخواه روی دامنه‌ای که مالک آن هستید و تأییدش کرده‌اید انتخاب کنید.
پیام‌ها را بخوانید
صندوق ورودی را فهرست کنید و هر پیام را به‌صورت JSON بخوانید: فرستنده، موضوع، متن، HTML پاک‌سازی‌شده و کد یک‌بارمصرف و لینک‌هایی که API پیدا کرده است.
نگهش دارید یا حذفش کنید
آدرس‌ها منقضی نمی‌شوند. همان صندوق ورودی را با لینک استفاده مجدد آن در tmailor.com باز کنید، یا پس از پایان تست، آدرس را حذف کنید.

ساختهشده برای جریانهای کاری ایمیل قابل تکرار

به هر اجرای تست، صندوق ورودی جداگانه خودش را بدهید، نه یک صندوق پستی واقعی مشترک.

تستهای ثبتنام و OTP

برای هر ثبتنام، بازنشانی رمز عبور یا بررسی کد یکبارمصرف، یک آدرس تازه بسازید و سپس کد را از پاسخ بخوانید.

خطوط لوله CI/CD

بررسیهای ایمیل سرتاسری را در خط لوله خود با کلید در یک متغیر محیطی اجرا کنید. طرحهای پولی درخواستها را از هر آدرس IP میپذیرند.

QA و محیط آزمایشی

به تسترها و محیطهای آزمایشی آدرسهای اختصاصی بدهید و صندوقهای ورودی واقعی را از دادههای تست دور نگه دارید.

آدرسها روی دامنه خودتان

دامنه ای که مالک آن هستید را اضافه کنید، رکورد MX آن را به ما اشاره دهید و آدرسهایی با نامهای سفارشی مطابق با قوانین نامگذاری ایجاد کنید.

طرح‌ها و قیمت‌گذاری

تعداد صندوق‌های پستی مورد نیازتان را انتخاب کنید. سهمیه شما هر ۳۰ روز یک بار بازنشانی می‌شود، حتی در طرح‌های سالانه.

رایگان

API را امتحان کنید و پروژه‌های کوچک را اجرا کنید.

$0 /ماه

100 صندوق پستی در هر ۳۰ روز
تا 30 درخواست در دقیقه
2,000 درخواست در روز
فراخوانی‌ها از یک IP مجاز
دامنه‌های مشترک و دامنه‌های خودتان

شروع رایگان

شروع

برای یک توسعه‌دهنده یا یک مجموعه تست کوچک.

$9 /ماه

3,000 صندوق پستی در هر ۳۰ روز
تا 300 درخواست در دقیقه
بدون سهمیه درخواست روزانه یا ماهانه
فراخوانی‌ها از هر آدرس IP
دامنه‌های مشترک و دامنه‌های خودتان

انتخاب شروع

Pro

برای تیم‌هایی که هر روز تست اجرا می‌کنند.

$29 /ماه

30,000 صندوق پستی در هر ۳۰ روز
تا 600 درخواست در دقیقه
بدون سهمیه درخواست روزانه یا ماهانه
فراخوانی‌ها از هر آدرس IP
دامنه‌های مشترک و دامنه‌های خودتان

انتخاب Pro

Business

برای شرکت‌هایی که اتوماسیون روزانه سنگینی دارند.

$99 /ماه

150,000 صندوق پستی در هر ۳۰ روز
تا 2,000 درخواست در دقیقه
بدون سهمیه درخواست روزانه یا ماهانه
فراخوانی‌ها از هر آدرس IP
دامنه‌های مشترک و دامنه‌های خودتان

انتخاب Business

Scale

برای مجموعه‌های تست بزرگ و خطوط لوله پرترافیک.

$199 /ماه

400,000 صندوق پستی در هر ۳۰ روز
تا 4,000 درخواست در دقیقه
بدون سهمیه درخواست روزانه یا ماهانه
فراخوانی‌ها از هر آدرس IP
دامنه‌های مشترک و دامنه‌های خودتان

انتخاب Scale

Enterprise

برای بالاترین حجم صندوق پستی و نرخ درخواست.

$499 /ماه

2,000,000 صندوق پستی در هر ۳۰ روز
تا 6,000 درخواست در دقیقه
بدون سهمیه درخواست روزانه یا ماهانه
فراخوانی‌ها از هر آدرس IP
دامنه‌های مشترک و دامنه‌های خودتان

انتخاب Enterprise

مقایسه طرح‌ها

این محدودیت‌ها از طرحی به طرح دیگر تغییر می‌کنند. بقیه موارد در همه طرح‌ها یکسان است.

مقایسه طرح‌ها
طرح	رایگان	شروع	Pro	Business	Scale	Enterprise
قیمت ماهانه	$0	$9	$29	$99	$199	$499
قیمت سالانه	$0	$90	$290	$990	$1,990	$4,990
صندوق‌های پستی در هر ۳۰ روز	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 میزبانی‌شده	فقط سرور محلی	شامل می‌شود	شامل می‌شود	شامل می‌شود	شامل می‌شود	شامل می‌شود

برای مقایسه همه طرح‌ها به طرفین بکشید.

در همه طرح‌ها موجود است

API REST با پاسخ‌های JSON
آدرس‌های تصادفی روی دامنه‌های مشترک
نام‌های سفارشی روی دامنه‌های تأییدشده خودتان
دامنه‌های شخصی نامحدود (حداکثر ۳ دامنه می‌توانند هم‌زمان در انتظار تأیید باشند)
آدرس‌هایی که منقضی نمی‌شوند
بدون محدودیت در تعداد آدرس‌هایی که نگه می‌دارید
پیام‌ها به مدت ۲۴ ساعت نگه داشته می‌شوند
استخراج کد یک‌بارمصرف و لینک (تا حد امکان)
یک لینک استفاده مجدد برای باز کردن صندوق ورودی در tmailor.com
SDKهای رسمی و یک ابزار خط فرمان
طرح‌ها قابل ترکیب‌اند و محدودیت‌هایشان با هم جمع می‌شود
فقط دریافت، بدون پیوست
حذف یک آدرس، سهمیه را برنمی‌گرداند

وقتی سهمیه صندوق پستی تمام شود، تا چرخه بعدی یا ارتقا نمی‌توان آدرس جدید ساخت. صندوق‌های ورودی موجود همچنان کار می‌کنند.
پرداخت‌ها طبق شرایط API غیرقابل‌بازگشت هستند. ابتدا یکپارچه‌سازی خود را در طرح رایگان آزمایش کنید.

SDKهای رسمی و CLI

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 جریان‌های ثبت‌نامی را که مالک آن هستید یا مجاز به تست آن هستید آزمایش کنند: عامل یک آدرس واقعی و فقط دریافت‌کننده می‌سازد، منتظر ایمیل می‌ماند و کد یک‌بارمصرف یا لینک تأیید را می‌خواند.

هر دو گزینه ابزارهای یکسانی در اختیار عامل می‌گذارند: ساخت آدرس، انتظار برای ایمیل و دریافت کد یک‌بارمصرف و لینک‌های آن، خواندن پیام‌ها، حذف آدرس‌ها و بررسی سهمیه. عامل فقط آدرس‌های ایمیل را می‌بیند، هرگز توکن‌های پشت آن‌ها را، و از همان سهمیه صندوق پستی و محدودیت نرخ 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_..."}}}}

اپ‌های متصل را در صفحه اتصالات هوش مصنوعی ببینید و هرکدام را قطع کنید. اپ قطع‌شده ظرف ۳۰ ثانیه دسترسی خود را از دست می‌دهد.

مشاهده پلن‌ها و محدودیت‌ها

سرور محلی

همهٔ طرح‌ها، حتی رایگان

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

امتحان کنید و بپرسید: «یک ایمیل موقت بساز، با آن در سایت استیجینگ من ثبت‌نام کن و کد تأیید را به من بگو.»

سوالات متداول API ایمیل موقت

چه چیزی یک صندوق پستی محسوب می‌شود؟

هر آدرس جدیدی که ایجاد می‌کنید، یک صندوق پستی از سهمیه چرخه ۳۰ روزه فعلی مصرف می‌کند. فهرست کردن، خواندن و حذف، صندوق پستی مصرف نمی‌کنند و حذف یک آدرس، صندوق پستی را برنمی‌گرداند.

آیا آدرس‌ها منقضی می‌شوند؟

خیر. آدرس تا زمانی که آن را حذف نکنید در حساب شما باقی می‌ماند. پیام‌های داخل آن به مدت ۲۴ ساعت نگهداری می‌شوند.

آیا می‌توانم ایمیل بفرستم یا پیوست دریافت کنم؟

خیر. API فقط دریافت می‌کند و پیوست‌ها تحویل داده نمی‌شوند.

آیا می‌توانم نام و دامنه آدرس را انتخاب کنم؟

در دامنه‌های مشترک ما، نام تصادفی است. برای انتخاب نام، دامنه‌ای را که مالک آن هستید در پلتفرم API اضافه و با تنظیم رکورد MX آن به سمت ما تأیید کنید، سپس آدرس‌هایی با نام سفارشی که از قوانین نام‌گذاری پیروی می‌کند ایجاد کنید.

آیا به فهرست مجاز IP نیاز دارم؟

فقط در طرح رایگان، که در آن تنها آدرس IP‌ای را که سرور شما از آن درخواست می‌فرستد اضافه می‌کنید. هر آدرس IP فقط می‌تواند به یک حساب رایگان تعلق داشته باشد، بنابراین ممکن است آدرس مشترک یک دفتر یا VPN از قبل در حال استفاده باشد. با یک طرح پولی فعال، API درخواست‌ها را از هر آدرس 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 تا صندوق ورودی در چهار مرحله

یک کلید API بسازید

یک آدرس بسازید

پیام‌ها را بخوانید

نگهش دارید یا حذفش کنید

ساختهشده برای جریانهای کاری ایمیل قابل تکرار

تستهای ثبتنام و OTP

خطوط لوله CI/CD

QA و محیط آزمایشی

آدرسها روی دامنه خودتان

طرح‌ها و قیمت‌گذاری

رایگان

شروع

Pro

Business

Scale

Enterprise

مقایسه طرح‌ها

در همه طرح‌ها موجود است

SDKهای رسمی و CLI

Python

Node.js

PHP

سرور MCP برای عامل‌های هوش مصنوعی

سرور میزبانی‌شده

سرور محلی

سوالات متداول API ایمیل موقت

اولین آدرس خود را در چند دقیقه بسازید