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

حذف یک پیام

یک پیام، بدنه و پیوست‌هایش، به درخواست شما و نه با جاروی خودکار.

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

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

DELETE /temp-mail/inboxes/{id}/messages/{messageId}

یک پیام، بدنه و پیوست‌هایش، به درخواست شما و نه با جاروی خودکار.

توکن صندوق

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

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

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

نمونه

ردیف و هر شیئی که زیر آن است با هم می‌روند. messageCount تغییر نمی‌کند: سقف 50 پیام آنچه را رسیده می‌شمارد، پس حذف، فضا آزاد می‌کند نه جا.

curl
curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages/tmail_4b81c07d2fa9418e93c6a13f" \  -H "$INBOX"
پاسخ
{ "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "deleted": true }

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

صندوق پر، پر می‌ماند. نامه‌ای که به آن برسد همان دمِ در رها می‌شود، بدون برگشت‌خوردن و بدون چیزی که بعداً بتوان بازیابی کرد، پس راه ادامه یک نشانی تازه است نه خالی‌کردن صندوق.