Endpoint API v2 /emails Ora Disponibili

Siamo entusiasti di annunciare che gli endpoint email sono ora disponibili nell’API v2! Ora puoi inviare, recuperare, aggiornare email programmate e annullare email in sospeso — tutto attraverso la nostra potente API REST.

Nuovi Endpoint

Invio Email

POST /v2/emails

Invia una singola email a uno o più destinatari. L’endpoint di invio supporta:

• Destinatari multipli — Invia fino a 50 destinatari (TO, CC, BCC combinati)
• Template — Utilizza alias o ID di template con sostituzione di variabili usando la sintassi {{variabile}}
• Allegati — Includi file tramite contenuto base64 o URL
• Programmazione — Programma email per consegne future usando ISO 8601, timestamp Unix, o linguaggio naturale come “domani alle 9”
• Tracciamento — Sovrascrivi le impostazioni predefinite del dominio per aperture e clic
• Metadati — Allega coppie chiave-valore personalizzate che vengono memorizzate e restituite con l’email
• Idempotenza — Previeni invii duplicati con l’header Idempotency-Key

Ogni destinatario riceve il proprio ID email univoco per il tracciamento individuale quando si invia a più indirizzi.

Recupera Email

GET /v2/emails/{id}

Recupera informazioni dettagliate su una specifica email, inclusi:

• Stato attuale (in sospeso, programmata, inviata, consegnata, respinta, annullata)
• Header e contenuto email grezzi
• Impostazioni di tracciamento
• Metadati personalizzati
• Timestamp per creazione e aggiornamenti

Aggiorna Email Programmata

POST /v2/emails/{id}

Riprogramma un’email impostata per consegna futura. Puoi modificare l’orario programmato purché l’email sia almeno a 3 minuti dall’invio.

Annulla Email

POST /v2/emails/{id}/cancel

Annulla un’email programmata o in sospeso prima che venga inviata. Per le email programmate, l’annullamento deve essere richiesto almeno 3 minuti prima dell’orario di invio programmato.

Limiti di Velocità

Ogni risposta include header dei limiti di velocità così puoi monitorare il tuo utilizzo:

• ratelimit-limit — Richieste massime per secondo
• ratelimit-remaining — Richieste rimanenti nel secondo corrente
• ratelimit-daily-limit — Richieste giornaliere massime
• ratelimit-daily-remaining — Richieste giornaliere rimanenti

Documentazione

La documentazione completa con esempi di codice in Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET e cURL è disponibile:

• Invio Email
• Recupera Email
• Aggiorna Email Programmata
• Annulla Email

Prossimamente: API Template

Stiamo lavorando sull’API Template che ti permetterà di creare, aggiornare e gestire template email in modo programmatico. Resta sintonizzato per questa entusiasmante aggiunta!

Avviso di Deprecazione API v1

Importante: L’API v1 è stata deprecata e cesserà di funzionare alla fine di febbraio 2026. Se stai ancora utilizzando l’API v1, ti preghiamo di migrare all’API v2 il prima possibile.

Hai bisogno di aiuto per la migrazione? Consulta la nostra documentazione API v2 o contatta il nostro team di supporto.