Récupérer une boîte
Le bail, le nombre de messages et les prolongations restantes. L'état qu'un client dessine autour de la liste.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
GET /temp-mail/inboxes/{id}
Le bail, le nombre de messages et les prolongations restantes. L'état qu'un client dessine autour de la liste.
Le jeton de boîte
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"Chaque appel ci-dessous transporte le jeton 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 l'intérêt même de la fonctionnalité plutôt qu'une formalité : une adresse jetable est remise, dès qu'elle est émise, à la partie que vous tenez à distance.
L'id dans le chemin doit désigner la même boîte que le jeton. Le jeton seul en identifie une, c'est donc ceinture et bretelles, mais cela signifie qu'un appelant qui confond deux boîtes reçoit un 404 au lieu de lire discrètement le mauvais courrier.
Exemple
Peu coûteux : une ligne indexée et aucun accès au stockage objet. Interrogez plutôt la liste des messages si ce que vous voulez, c'est le courrier. Cet appel transporte aussi l'expiration.
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72" -H "$INBOX"{ "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"}Une boîte expirée, détruite ou inconnue donne une seule réponse : 404. « Votre bail a expiré », « ce n'est pas la vôtre » et « cela n'a jamais existé » sont volontairement indiscernables de l'extérieur, et la messagerie refuse de les distinguer pour la même raison.