API

نابودی یک صندوق

به جای انتظار برای پایان مهلت، نامه‌ها را همین حالا حذف می‌کند.

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

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

DELETE /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 می‌گیرد.

نمونه

پیام‌ها و بدنه‌های ذخیره‌شده‌شان بی‌درنگ می‌روند، و توکن در درخواست بعدی از احراز هویت می‌افتد.

curl

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

پاسخ

{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

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

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