Belgelere geç
API

Kiralamayı uzat

Son kullanma zamanına bir saat daha, kiralamanın sınırlandığı güne kadar. Gövde yok.

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

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

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

Son kullanma zamanına bir saat daha, kiralamanın sınırlandığı güne kadar. Gövde yok.

Gelen kutusu token'ı

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

Aşağıdaki her çağrı, POST /temp-mail/inboxes çağrısının döndürdüğü token'ı, bir API anahtarının kullandığı aynı Authorization: Bearer başlığında taşır. Adresin kendisi hiçbir yetki vermez ve bu ayrım, bir formalite değil, özelliğin asıl amacıdır: tek kullanımlık bir adres, verildiği anda mesafeli durduğunuz tarafa teslim edilir.

Yoldaki id, token'ın adlandırdığı gelen kutusunun aynısını adlandırmalıdır. Token tek başına bir gelen kutusunu tanımlar, dolayısıyla bu bir ek güvencedir; ama iki gelen kutusunu karıştıran bir çağıranın sessizce yanlış postayı okuması yerine 404 alması anlamına gelir.

Örnek

Saat, şimdiye değil expiresAt değerine eklenir; böylece süre dolmadan yapılan uzatma, kalan süreyi korur.

curl
curl -X POST "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/extend" -H "$INBOX"
Yanıt
{  "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"}

Yirmi üç uzatma; ayrıca yeni son kullanma zamanı createdAt üzerine 24 saatle sınırlanır, dolayısıyla sonuncusu tam bir saatten az kazandırabilir ve sınırda oluşturulmuş bir kiralamanın hiç uzatması olmaz. extensionsLeft her iki tavanı da hesaba katar; kendi çağrılarınızı saymak yerine onu ve expiresAt değerini geri okuyun.

Sınıra gelindiğinde 409 conflict_error / extension_limit yanıtı verir. İşin sonu budur: yeni bir adres alın ya da süresi dolmayan gerçek bir posta kutusu edinin.