# Controllo delle versioni

> L’API di Emailit è alla versione 2. Come viene indicata la versione, cosa cambia senza una nuova versione, l’API v1 deprecata e il passaggio agli ID degli oggetti con prefisso.

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

| Versione | URL di base | Stato |
| --- | --- | --- |
| v2 | `https://api.emailit.com/v2` | Attuale. Rilasciata a ottobre 2025. Tutto ciò che trovi in questo riferimento è v2. |
| v1 | `https://api.emailit.com/v1` | Deprecata. La generazione precedente dell’API. Non riceve nuove funzioni e non è più documentata. |

Se chiami ancora la v1, sposta la tua integrazione sulla v2. Gli [SDK](/it/docs/sdks/) 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](/it/docs/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](/it/docs/api-reference/#object-ids).

- 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

  - [Changelog](/it/docs/changelog/): Nuove funzioni e modifiche, a partire dalle più recenti.
  - [Riferimento API](/it/docs/api-reference/): URL di base, autenticazione e risorse.

---
Fonte: https://emailit.com/it/docs/api-reference/versioning/