Saltar para a documentação
API

Obter uma caixa de entrada

A concessão, o número de mensagens e as extensões restantes. O estado que um cliente apresenta à volta da lista.

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

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

GET /temp-mail/inboxes/{id}

A concessão, o número de mensagens e as extensões restantes. O estado que um cliente apresenta à volta da lista.

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

Barato: uma linha indexada e nenhum acesso ao armazenamento de objetos. Se o que quer é correio, consulte antes periodicamente a lista de mensagens. Essa chamada também inclui a expiração.

curl
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -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-01T12:00:00.000Z",  "extensionsLeft": 22,  "messageCount": 3,  "messageLimit": 50,  "lastMessageAt": "2026-09-01T10:31:04.000Z"}

Uma caixa de entrada expirada, destruída ou desconhecida tem uma única resposta: 404. "A sua concessão terminou", "isso não é seu" e "isso nunca existiu" são propositadamente indistinguíveis vistos de fora, e a caixa de correio recusa-se a distingui-los pela mesma razão.