Controllo delle versioni

La versione dell’API fa parte dell’URL di base, quindi ogni richiesta indica la versione per cui è stata scritta. Questa pagina spiega quali versioni esistono, cosa può cambiare all’interno di una versione e come sono cambiati gli ID degli oggetti nel 2026.

Versioni

Se chiami ancora la v1, sposta la tua integrazione sulla v2. Gli SDK usano tutti la v2.

Modifiche all’interno della v2

Emailit amplia la v2 senza cambiare la versione nell’URL. Queste modifiche possono avvenire in qualsiasi momento:

• Nuovi endpoint e nuove risorse.
• Nuovi parametri di richiesta e header facoltativi.
• Nuovi campi negli oggetti di risposta e nei payload dei webhook.
• Nuovi tipi di evento, stati e altri valori enum.

Scrivi client che le tollerino: ignora i campi della risposta che non riconosci, non andare in errore con uno stato o un tipo di evento sconosciuto e non dipendere dall’ordine dei campi in un oggetto JSON.

Le modifiche all’API vengono annunciate nel changelog.

ID degli oggetti

A gennaio 2026 tutti gli oggetti sono passati agli ID con prefisso: un prefisso di tipo seguito da 27 lettere e cifre, come em_4KYof1ZzXndZE2VPi0DgULiekG8 per un’email o dom_4K468YrjOkR1wwdhqiO0G9XEUey per un dominio. Tutti gli endpoint accettano e restituiscono questi ID. Per l’elenco di tutti i prefissi, vedi ID degli oggetti.

• Salva gli ID come stringhe e confrontali in modo esatto. Distinguono tra maiuscole e minuscole.
• I domini di invio che esistevano prima del cambiamento mantengono ID che iniziano con sd_ o sed_. Funzionano ovunque funzioni un ID dom_, quindi non convalidare gli ID dei domini in base al prefisso.
• Le chiavi API sono secret, non ID. Le nuove chiavi iniziano con secret_ e le chiavi più vecchie senza prefisso continuano a funzionare. L’ID di una chiave API inizia con key_.

Vedi anche