Aller à la documentation
API

Détruire une boîte de réception

Supprime le courrier maintenant au lieu d'attendre la fin du bail.

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

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

DELETE /temp-mail/inboxes/{id}

Supprime le courrier maintenant au lieu d'attendre la fin du bail.

Le token de la boîte

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

Chaque appel ci-dessous porte le token renvoyé par POST /temp-mail/inboxes, dans le même en-tête Authorization: Bearer qu'utilise une clé API. L'adresse elle-même n'autorise rien, et cette séparation est tout l'intérêt de la fonctionnalité plutôt qu'une formalité : une adresse jetable est remise, dès son émission, à la partie que vous tenez à distance.

L'id du chemin doit nommer la même boîte que le token. Le token identifie à lui seul une boîte : c'est donc ceinture et bretelles, mais cela signifie qu'un appelant qui confond deux boîtes obtient un 404 au lieu de lire en silence le mauvais courrier.

Exemple

Les messages et leurs corps stockés partent immédiatement, et le token cesse d'authentifier dès la requête suivante.

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

Rien n'est stocké côté serveur. Le bail est un jeton signé que le navigateur conserve : une boîte expirée ne laisse donc aucune ligne derrière elle et l'adresse cesse simplement d'être réservée.

Une boîte détruite compte toujours dans le plafond de création. En jeter une n'est pas un moyen d'en obtenir une autre.