दस्तावेज़ पर जाएँ
API

लीज़ बढ़ाएँ

एक्सपायरी पर एक और घंटा, उस सीमा तक जहाँ लीज़ एक दिन पर रुक जाती है। कोई body नहीं।

POSTapi.openemail.uk/temp-mail/inboxes/{id}/extend

असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।

POST /temp-mail/inboxes/{id}/extend

एक्सपायरी पर एक और घंटा, उस सीमा तक जहाँ लीज़ एक दिन पर रुक जाती है। कोई body नहीं।

इनबॉक्स टोकन

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

नीचे की हर कॉल वही टोकन ले जाती है जो POST /temp-mail/inboxes ने लौटाया था, उसी Authorization: Bearer हेडर में जिसे API key इस्तेमाल करती है। पता स्वयं किसी चीज़ का अधिकार नहीं देता, और यही अलगाव इस फ़ीचर की असली बात है, औपचारिकता नहीं: डिस्पोज़ेबल पता जारी होते ही उसी पक्ष को थमा दिया जाता है जिसे आप दूरी पर रख रहे हैं।

path में दिया गया id उसी इनबॉक्स का नाम होना चाहिए जिसका टोकन है। टोकन अकेले ही एक इनबॉक्स की पहचान कर देता है, इसलिए यह दोहरी सुरक्षा है, पर इसका मतलब है कि दो इनबॉक्स गड्डमड्ड करने वाले कॉलर को चुपचाप ग़लत मेल पढ़ने के बजाय 404 मिलता है।

उदाहरण

घंटा expiresAt में जोड़ा जाता है, अभी के समय में नहीं, इसलिए घड़ी में समय बचे रहते बढ़ाने पर वह बचा हुआ समय बना रहता है।

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"
प्रतिक्रिया
{  "object": "temp_inbox",  "id": "tinb_9c2f41ab7d3e4c118a0f5d72",  "address": "[email protected]",  "domain": "freemailaddress.com",  "createdAt": "2026-09-01T10:00:00.000Z",  "expiresAt": "2026-09-01T13:00:00.000Z",  "extensionsLeft": 21,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

तेईस बार बढ़ाया जा सकता है, और नई एक्सपायरी createdAt के 24 घंटे बाद पर भी सीमित होती है, इसलिए आख़िरी बार पूरे घंटे से कम मिल सकता है, और सीमा पर बनी लीज़ को कुछ भी नहीं मिलता। extensionsLeft पहले ही दोनों छतों को गिन लेता है; अपनी कॉलें गिनने के बजाय उसे और expiresAt को पढ़ें।

सीमा पर यह 409 conflict_error / extension_limit देता है। बस इतना ही: नया पता लें, या असली मेलबॉक्स, जिसकी कोई एक्सपायरी नहीं होती।