Saltar para a documentação
API

Destruir uma caixa de entrada

Apaga o correio agora, em vez de esperar que a concessão termine.

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

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

DELETE /temp-mail/inboxes/{id}

Apaga o correio agora, em vez de esperar que a concessão termine.

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

As mensagens e os respetivos corpos guardados desaparecem imediatamente, e o token deixa de autenticar no pedido seguinte.

curl
curl -X DELETE "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"
Resposta
{ "object": "temp_inbox", "id": "tinb_9c2f41ab7d3e4c118a0f5d72", "destroyed": true }

Nada é guardado no servidor. A concessão é um token assinado que o browser guarda, pelo que uma caixa de entrada expirada não deixa nenhuma linha e o endereço simplesmente deixa de estar reservado.

Uma caixa de entrada destruída continua a contar para o limite de emissão. Deitar uma fora não é forma de obter outra.