Courrier temporaire pour les agents IA
Une API d’e-mail temporaire sans inscription que les agents peuvent découvrir et utiliser de manière autonome. Créez une boîte de réception, attendez les codes de vérification, lisez et supprimez les messages et récupérez leur source brute via HTTPS.
# Découvrez les domaines disponibles :
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Créez une boîte de réception temporaire privée. Sans inscription ni clé API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Attendez un e-mail de vérification ou un code OTP.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
-H 'Authorization: Inbox {token}' \
-H 'Content-Type: application/json' \
-d '{"codeOnly":true,"timeoutSeconds":60}'
# 3. Lisez le message complet.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"token": "use-this-as-an-inbox-token",
"tokenExpiresAt": "2026-06-09T18:30:00.000Z",
"links": {
"web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
"messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
"wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
}
}{
"status": "message",
"inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Interface pour agents
Le manifeste de découverte est disponible sur /v1/agent-tempmail et reproduit sur llms.txt pour les moteurs de réponses.
| Méthode | Chemin | Utilisation |
|---|---|---|
| GET | /v1/agent-tempmail | Manifeste de découverte pour les agents et les robots |
| GET | /v1/agent-tempmail/domains | Liste des domaines alternatifs disponibles |
| POST | /v1/agent-tempmail/inboxes | Créer une boîte de réception privée protégée par mot de passe |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Lister les messages reçus |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Attendre des e-mails ou des codes par long polling |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Lire un message |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Récupérer le message brut au format RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Supprimer un message |
Flux de vérification
Utilisez une boîte de réception d'agent pour les e-mails d'inscription, de connexion, de réinitialisation de mot de passe et de confirmation d'essai.
Automatisation du navigateur
Associez-la à Playwright, Selenium ou à un agent de navigation qui a besoin d’une adresse e-mail réelle capable de recevoir des messages.
CI et QA
Créez des boîtes de réception isolées pour chaque exécution de test, sans créer de comptes ni partager d’identifiants.
FAQ
La création d’une boîte privée est gratuite et sans inscription. Pour choisir un autre domaine, transmettez un domaine obtenu depuis le point de terminaison de la liste. L’interface pour agents sert uniquement à recevoir des messages. Pour des volumes plus élevés ou l’envoi de messages, utilisez les API associées à un compte.
Puis-je utiliser une clé d'accès avec une boîte de réception d'agent ?+
Oui. Connectez-vous avec le mot de passe généré et ajoutez une clé d’accès dans les paramètres de la boîte de réception. Le bouton avec l’icône de clé du formulaire de boîte privée et l’écran de déverrouillage permettent la connexion par clé d’accès. Le jeton Inbox obtenu fonctionne avec tous les points de terminaison de messagerie pour agents. Les clés d’accès nécessitent une vérification interactive de l’utilisateur ; conservez le mot de passe pour les agents sans surveillance et renouvelez les jetons expirés avec POST /v1/inbox/{address}/token et JSON {"password":"..."}.
Puis-je choisir un autre domaine ?+
Oui. GET /v1/agent-tempmail/domains répertorie les domaines disponibles. Indiquez domain avec prefix ou avec un address contenant uniquement la partie avant l’arobase, ou fournissez un address complet. Les adresses existantes ou réservées ne peuvent pas être enregistrées.
Un agent IA peut-il l'utiliser sans s'inscrire ?+
Oui. L’agent peut créer une boîte de réception avec une seule requête POST non authentifiée. La réponse comprend un mot de passe généré et un Inbox token. Toutes les boîtes créées sont privées. Conservez le mot de passe pour vous connecter normalement après expiration du jeton.
MCP, un SDK ou une installation sont-ils nécessaires ?+
Non. L’interface est entièrement accessible via HTTPS et curl. Les agents peuvent la découvrir grâce à llms.txt ou au manifeste JSON à l’adresse /v1/agent-tempmail.
Les agents peuvent-ils envoyer des e-mails via cette API ?+
Non. L’interface pour agents sans inscription permet uniquement de recevoir, lire et attendre des messages, d’obtenir leur source et de les supprimer. L’envoi d’e-mails est volontairement exclu de cette interface publique.
Comment les codes de vérification sont-ils fournis ?+
Les réponses de liste, d’attente et de détail privilégient les en-têtes expérimentaux OTP-Token valides ; à défaut, elles recherchent les codes dans le texte. Les codes issus des en-têtes incluent verificationCodeOrigin : avant de transmettre le code, vérifiez que le schéma, l’hôte et le port correspondent exactement à l’origine de la destination prévue. Cette valeur est fournie par l’expéditeur et ne prouve pas son identité. Ne naviguez jamais automatiquement vers une adresse fournie par l’expéditeur.
Combien de temps les boîtes de réception créées par les agents sont-elles conservées ?+
Les boîtes de réception créées par les agents offrent les fonctionnalités habituelles des boîtes privées et conservent les messages pendant 180 jours.