Developers

Sviluppa con l’API ChatTempMail

Email temporanea con superpoteri IA — API REST, specifica OpenAPI 3.1, server MCP, agent skill e webhook. Chiave API e casella usa e getta in meno di un minuto.

Guida rapida

Tre chiamate fino al primo codice di verifica. URL di base: https://chat-tempmail.com. Tutti gli endpoint accettano X-API-Key o 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"

Risorse leggibili dalle macchine

URL prevedibili che gli agenti possono scoprire per nome:

Specifica OpenAPI 3.1

Schema completo dell’API REST con operationId, parametri tipizzati e schemi di risposta. Anche su /api/openapi.json e /.well-known/openapi.json.

llms.txt

Panoramica di sito e API in markdown, con una sezione when-to-use per gli agenti. Servita come text/markdown inviando Accept: text/markdown.

Server MCP

Accesso nativo agli strumenti per Claude, Cursor e VS Code. Esegue in locale via npm: mcp-server-tempmail.

Agent skill

Skill installabile che insegna agli agenti di coding lintero flusso: crea casella, interroga, elabora con IA.

CLI e pacchetto MCP

npx mcp-server-tempmail funziona da solo come strumento in stile CLI; pacchetto npm ufficiale.

Autenticazione

Niente danze OAuth: crea una chiave API dalla pagina Profilo e inviala come header. Le chiavi hanno gli stessi permessi del tuo account — rigenera subito in caso di fughe.

1Accedi e apri la pagina Profilo
2Crea una chiave API (mostrata una sola volta — conservala al sicuro)
3Invia X-API-Key: YOUR_API_KEY (o Authorization: Bearer YOUR_API_KEY) con ogni richiesta

X-API-Key: YOUR_API_KEY

Webhook

Invece di interrogare, configura un webhook (POST /api/webhook) e ChatTempMail invierà con POST ogni messaggio in arrivo al tuo URL con header X-Webhook-Event: new_message. Rispondi 2xx rapidamente; le consegne fallite vengono ritentate, quindi mantieni l’endpoint idempotente.

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}'

Sandbox e limiti di frequenza

Non esiste una sandbox separata: ogni account può creare indirizzi temporanei gratis. I piani a pagamento sbloccano operazioni IA (riassumere/tradurre/QA/estrarre), indirizzi permanenti e allegati. Gli endpoint di elenco restituiscono 20 elementi per pagina; la paginazione è basata su cursore. Gli endpoint IA hanno limiti giornalieri per ruolo visibili negli header di risposta X-AI-Remaining.

Supporto

Domande, segnalazioni bug, richieste di funzionalità:

GitHub Email