API Reference

Documentazione completa dell'API REST per Tratto Email. Tutti gli endpoint richiedono autenticazione con una chiave API.

URL di Base

https://api.tratto.email/v1/

Autenticazione

Includi la tua chiave API come bearer token:

Authorization: Bearer tratto_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Reference Interattiva

Per documentazione dettagliata degli endpoint, esempi di richiesta/risposta, e un explorer API live, visita il riferimento interattivo.

Il riferimento interattivo include:

• Documentazione completa degli endpoint: Metodo, percorso, parametri, schema richiesta/risposta
• Requisiti di autenticazione: Quali endpoint richiedono la chiave API
• Codici di errore: Tutte le possibili risposte di errore
• Pannello Try it: Fai richieste API reali dalla documentazione (la tua chiave API rimane nel browser)
• Esempi di codice: cURL, JavaScript, Python

Link Rapidi

• Invia Email: POST /emails
• Status Email: GET /emails/{id}
• Domini: Verifica dei domini
• Template: Template di email
• Contatti: Gestione contatti
• Webhook: Sottoscrizioni agli eventi
• Analytics: Metriche e statistiche

Rate Limiting

Le richieste sono limitate a 100 al secondo per chiave API e 500 al minuto per IP client. Vedi Rate Limits per dettagli.

Gestione Errori

Tutti gli errori restituiscono JSON con codice e messaggio:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key.",
    "docs": "https://docs.tratto.email/en/docs/error-codes"
  }
}

Vedi Error Codes per il riferimento completo.

👉 Inizia dal riferimento API interattivo per esplorare tutti gli endpoint.