Aller à la documentation
API

Prolonger le bail

Une heure de plus sur l'expiration, jusqu'au plafond d'une journée par bail. Aucun corps de requête.

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

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

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

Une heure de plus sur l'expiration, jusqu'au plafond d'une journée par bail. Aucun corps de requête.

Le jeton de boîte

shell
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

L'heure s'ajoute à expiresAt, pas à l'instant présent : prolonger alors qu'il reste du temps conserve ce temps.

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

Vingt-trois prolongations, et la nouvelle expiration est aussi bornée à 24 heures après createdAt : la dernière peut donc rapporter moins d'une heure pleine, et un bail créé au plafond n'en obtient aucune. extensionsLeft tient déjà compte des deux plafonds ; relisez-le avec expiresAt plutôt que de compter vos propres appels.

Au plafond, la réponse est 409 conflict_error / extension_limit. C'est terminé : prenez une nouvelle adresse, ou une vraie boîte mail, qui n'expire pas.