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) را دقیقاً با مقصد موردنظر مطابقت دهید. این مقدار را فرستنده ارائه می‌کند و مدرک هویت او نیست؛ هرگز به‌طور خودکار به نشانی ارائه‌شده توسط فرستنده نروید.

صندوق‌های ورودی ایجادشده توسط عامل تا چه مدت نگهداری می‌شوند؟+

صندوق‌های ورودی ایجادشده توسط عامل قابلیت‌های معمول صندوق خصوصی را دارند و پیام‌های آن‌ها به مدت ۱۸۰ روز نگهداری می‌شوند.