API

دریافت یک صندوق

اجاره، شمار پیام‌ها و تمدیدهای باقی‌مانده. همان وضعیتی که کلاینت دور فهرست می‌کشد.

GETapi.openemail.uk/temp-mail/inboxes/{id}

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

GET /temp-mail/inboxes/{id}

اجاره، شمار پیام‌ها و تمدیدهای باقی‌مانده. همان وضعیتی که کلاینت دور فهرست می‌کشد.

توکن صندوق

shell

export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"

هر فراخوانی پایین، توکنی را حمل می‌کند که POST /temp-mail/inboxes برگردانده است، در همان هدر Authorization: Bearer که یک کلید API از آن استفاده می‌کند. خودِ نشانی هیچ مجوزی نمی‌دهد، و این جدایی نه یک تشریفات، که اصل ماجرای این قابلیت است: نشانی یک‌بارمصرف در همان لحظهٔ صدور به طرفی سپرده می‌شود که می‌خواهید در فاصله نگهش دارید.

شناسهٔ داخل مسیر باید همان صندوقی را نام ببرد که توکن نام می‌برد. توکن به‌تنهایی صندوق را مشخص می‌کند، پس این محکم‌کاری مضاعف است، اما یعنی فراخوانی که دو صندوق را قاطی کند به‌جای آنکه بی‌سروصدا نامهٔ اشتباه را بخواند، 404 می‌گیرد.

نمونه

ارزان است: یک ردیف ایندکس‌شده و بدون هیچ فضای ذخیره‌سازی شیء. اگر آنچه می‌خواهید نامه است، به‌جای این، فهرست پیام‌ها را poll کنید؛ آن فراخوانی زمان انقضا را هم با خود می‌آورد.

curl

curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"

پاسخ

{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T12:00:00.000Z",  "extensionsLeft": 22,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

صندوق منقضی، نابودشده یا ناشناخته یک پاسخ دارد: 404. «اجاره‌تان تمام شد»، «این مال شما نیست» و «این هرگز وجود نداشته» از بیرون عمداً از هم قابل تشخیص نیستند، و صندوق پستی هم به همین دلیل از تفکیکشان سر باز می‌زند.