API email per sviluppatori
Un'API email veloce da integrare e facile da testare.
Tratto è un'API email per sviluppatori: un'unica API REST per email transazionali, campagne e flow di automazione, con SDK per Node.js, Python e PHP. Le chiavi di test fanno girare tutta la pipeline senza consegnare nulla, gli invii sono idempotenti e i webhook sono firmati. I dati restano in UE, e ci sono 3.000 email gratis ogni mese.
Entra nella betaInvia un'email
import { Tratto } from '@tratto/email';
const tratto = new Tratto(process.env.TRATTO_API_KEY!);
const { id } = await tratto.emails.send({
from: 'Acme <[email protected]>',
to: '[email protected]',
subject: 'Welcome!',
markdown: '# Welcome\n\nGlad to have you on board.',
});Il Markdown viene renderizzato lato server in HTML responsive con una parte di solo testo. Funzionano anche html e templateId.
Cosa ottieni
SDK per Node.js, Python e PHP
@tratto/email include i tipi TypeScript; tratto-email non ha dipendenze esterne e gira su Python 3.10+; tratto/email gira su PHP 8.1+ con l'estensione curl e nient'altro. Ogni altro linguaggio usa l'API REST in semplice HTTP.
Chiavi di test e simulatore
Una chiave tratto_test_ fa girare la stessa pipeline (stati, timeline, webhook) ma non consegna nulla e non richiede un dominio verificato. Gli indirizzi del simulatore producono a richiesta una consegna, un bounce permanente o temporaneo, o un reclamo.
Invii idempotenti
Invia l'header Idempotency-Key e un nuovo tentativo entro 24 ore restituisce la risposta originale invece di una seconda email. Un payload diverso con la stessa chiave viene rifiutato.
Webhook firmati
Ogni consegna di webhook è firmata in HMAC-SHA256 su timestamp e payload, nell'header X-Tratto-Signature, così puoi rifiutare tutto ciò che non arriva da Tratto.
Email in Markdown
Scrivi l'email in Markdown emailmd e l'API la renderizza in HTML responsive e sicuro per le email, più una parte di testo. Anche i template accettano Markdown.
Programmazione
Passa scheduledAt per inviare un'email o una campagna più tardi; un'email programmata si può annullare o spostare prima che parta.
Domande
- Quali linguaggi sono supportati?
- Ci sono SDK ufficiali per Node.js (@tratto/email), Python (tratto-email) e PHP (tratto/email). Ogni altro linguaggio usa direttamente l'API REST; la documentazione ha esempi in semplice HTTP.
- Posso provarla senza verificare un dominio?
- Sì, con una chiave di test (tratto_test_). Gli invii di test attraversano tutta la pipeline, stati e webhook compresi, senza essere consegnati e senza un dominio verificato. Non consumano la quota mensile e hanno un limite di 100 email al giorno.
- Tratto supporta SMTP?
- Non ancora: un relay SMTP è in roadmap. Oggi Tratto è un'API REST con SDK per Node.js, Python e PHP.
- Posso usare React Email?
- Non c'è un'integrazione con React Email. Puoi renderizzare i tuoi componenti in HTML e inviare il risultato nel campo html, oppure scrivere l'email in Markdown e lasciare che sia l'API a renderizzarla.
- Dove sono conservati i dati?
- In region UE: Firestore eur3 per il database, BigQuery europe-west1 per gli eventi email, AWS SES eu-west-1 per la consegna. Ogni fornitore è elencato nella pagina dei sub-responsabili.