پرش به مستندات
API

فهرست پیام‌ها

آنچه رسیده است، تازه‌ترین اول، فقط فراداده. این همان فراخوانی است که باید poll شود.

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

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

GET /temp-mail/inboxes/{id}/messages

آنچه رسیده است، تازه‌ترین اول، فقط فراداده. این همان فراخوانی است که باید poll شود.

توکن صندوق

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

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

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

نمونه

هر چیزی که فهرست ترسیم می‌کند، ستونی روی یک جدول ایندکس‌شده است و هیچ بدنهٔ ذخیره‌شده‌ای خوانده نمی‌شود. limit از 1 تا 50 و اختیاری است؛ اجاره در همان پاسخ برمی‌گردد، پس poll‌کننده برای دانستن زمان توقف به فراخوانی دومی نیاز ندارد.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"
پاسخ
{  "object": "list",  "data": [    {      "object": "temp_message",      "id": "tmail_4b81c07d2fa9418e93c6a13f",      "from": { "name": "Acme", "email": "[email protected]" },      "to": "[email protected]",      "subject": "Confirm your email",      "snippet": "Your code is 481923…",      "spam": false,      "seen": false,      "attachmentCount": 0,      "sizeBytes": 8241,      "receivedAt": "2026-09-01T10:31:04.000Z"    }  ],  "expiresAt": "2026-09-01T12:00:00.000Z"}

snippet چهارصد نویسهٔ نخست بدنه به‌صورت متن است، که معمولاً تمام دلیل وجود آن صندوق است. یک کد تأیید عموماً بدون بازکردن چیزی دیده می‌شود.

spam نظر همان اکتشافِ مشترک است. صرفاً یک پرچم است و نه چیزی بیشتر: چیزی بایگانی، جابه‌جا یا سرکوب نشده، و پیام در هر حال در همین فهرست است.

seen وقتی برمی‌گردد که پیام دریافت شود، نه وقتی فهرست شود. poll‌کردن این اندپوینت هرگز چیزی را خوانده‌شده علامت نمی‌زند.