ChatTempMail
Developers

Créez avec l’API ChatTempMail

E-mail jetable dopé à l’IA — API REST, spécification OpenAPI 3.1, serveur MCP, agent skill et webhooks. Une clé API et une boîte jetable en moins d’une minute.

Démarrage rapide

Trois appels jusqu’à votre premier code de vérification. URL de base : https://chat-tempmail.com. Tous les points de terminaison acceptent X-API-Key ou Authorization: Bearer.

1) List available domains
curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"
2) Create a disposable address (1 hour)
curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'
3) Poll for messages
curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

Ressources lisibles par machine

Des URLs prévisibles que les agents peuvent découvrir par leur nom :

Spécification OpenAPI 3.1

Schéma complet de l’API REST avec operationIds, paramètres typés et schémas de réponse. Également sur /api/openapi.json et /.well-known/openapi.json.

llms.txt

Aperçu du site et de lAPI en markdown, avec une section when-to-use pour les agents. Servi en text/markdown si vous envoyez Accept: text/markdown.

Serveur MCP

Accès natif aux outils pour Claude, Cursor et VS Code. Fonctionne en local via npm : mcp-server-tempmail.

Agent skill

Skill installable qui apprend aux agents de code tout le flux : créer une boîte, interroger, traiter par IA.

CLI et paquet MCP

npx mcp-server-tempmail fonctionne seul comme un outil type CLI ; paquet npm officiel.

Authentification

Pas de ballet OAuth : créez une clé API sur votre page Profil et envoyez-la en en-tête. Les clés portent les mêmes permissions que votre compte — régénérez-la immédiatement en cas de fuite.

  1. 1Connectez-vous et ouvrez votre page Profil
  2. 2Créez une clé API (affichée une seule fois — stockez-la en sécurité)
  3. 3Envoyez X-API-Key: YOUR_API_KEY (ou Authorization: Bearer YOUR_API_KEY) avec chaque requête
X-API-Key: YOUR_API_KEY

Webhooks

Au lieu d’interroger, configurez un webhook (POST /api/webhook) et ChatTempMail POSTera chaque message entrant vers votre URL avec un en-tête X-Webhook-Event: new_message. Répondez 2xx rapidement ; les livraisons échouées sont retentées, gardez donc le point de terminaison idempotent.

Configure a webhook
curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

Bac à sable et limites de débit

Pas de bac à sable séparé : chaque compte peut créer gratuitement des adresses temporaires. Les offres payantes déverrouillent les opérations IA (résumer/traduire/QA/extraire), les adresses permanentes et les pièces jointes. Les endpoints de liste renvoient 20 éléments par page ; la pagination est basée sur un curseur. Les endpoints IA ont des limites quotidiennes par rôle, exposées dans les en-têtes de réponse X-AI-Remaining.

Assistance

Questions, rapports de bugs, demandes de fonctionnalités :

GitHub E-mail
    Portail développeur ChatTempMail - ChatTempMail