Saltar para a documentação
API

Estender a concessão

Mais uma hora na expiração, até ao dia que limita uma concessão. Sem corpo.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

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

Mais uma hora na expiração, até ao dia que limita uma concessão. Sem corpo.

O token da caixa de entrada

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

Todas as chamadas abaixo levam o token devolvido por POST /temp-mail/inboxes, no mesmo cabeçalho Authorization: Bearer que uma chave de API usa. O endereço em si não autoriza nada, e essa separação é o objetivo da funcionalidade, não uma formalidade: um endereço descartável é entregue à parte que quer manter à distância no momento em que é emitido.

O id no caminho tem de designar a mesma caixa de entrada que o token. O token, por si só, identifica uma, pelo que isto é uma precaução redundante, mas significa que quem chama e confunde duas caixas de entrada recebe um 404 em vez de ler silenciosamente o correio errado.

Exemplo

A hora é somada a expiresAt, não ao momento atual, pelo que estender com tempo ainda por decorrer conserva esse tempo.

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

Vinte e três extensões, e a nova expiração também é limitada a 24 horas após createdAt, pelo que a última pode acrescentar menos de uma hora completa, e uma concessão criada no limite não tem nenhuma. extensionsLeft já conta com ambos os limites; leia-o, juntamente com expiresAt, na resposta, em vez de contar as suas próprias chamadas.

No limite, responde 409 conflict_error / extension_limit. E acaba aí: obtenha um novo endereço, ou uma caixa de correio real, que não expira.