Migrazione dalle API precedenti

Le API precedenti restano attive fino al 28 febbraio 2027. Entro quella data le integrazioni vanno migrate alla versione 2026-09.

Cosa viene ritirato

API	Stato
`/api/v1/*` (Basic auth)	Attiva fino al 28/02/2027
`/api/v2/` e `/api/v2.1/` (chiave API)	Attiva fino al 28/02/2027
`/api/tracking/{ldv}`	Attiva fino al 28/02/2027
`/api/2026-09/*` (OAuth2 con App)	Versione attuale

Fino alla data di ritiro le API precedenti funzionano senza modifiche: non serve intervenire subito sulle integrazioni esistenti.

Come riconoscere una chiamata da migrare

Ogni risposta delle API precedenti porta tre header standard:


Deprecation: @1788393600
Sunset: Sun, 28 Feb 2027 23:59:59 GMT
Link: <https://<sottodominio>.spedisci.online/api/2026-09>; rel="successor-version"

Se il tuo software registra gli header delle risposte, la presenza di Sunset indica una chiamata ancora da migrare.

Cosa cambia

Area	Nella versione 2026-09
Credenziali	Un’App con Client ID e Client Secret (Impostazioni → API App (OAuth2)) al posto della chiave API (Impostazioni → Chiave API)
Accesso	Token temporaneo di un’ora, revocabile in qualsiasi momento
Indirizzi, pesi, importi	Una struttura unica in tutti gli endpoint: vedi Formato delle risposte
Errori	Codici stabili e dettaglio per campo
Dogana	Dichiarazione completa per articolo: vedi Spedizioni extra UE
Webhook	Registrazione, test e storico degli invii anche dalle API
Account	Fatture con PDF, saldo e movimenti del credito, distinte contrassegni, distinte resi e ritiri

Passi consigliati

Crea l’App in Impostazioni → API App (OAuth2). La chiave API esistente continua a funzionare: le due versioni convivono.
Aggiungi la gestione del token al tuo software: richiesta, conservazione e rinnovo alla scadenza. Vedi Autenticazione.
Migra un flusso alla volta, partendo da preventivo e creazione della spedizione, poi tracking, ritiri, chiusura giornata e giacenze.
Adegua la lettura delle risposte al nuovo formato: stato come oggetto, importi e pesi come oggetti, date in ISO 8601.
Verifica i webhook: gli endpoint già registrati continuano a ricevere gli stessi avvisi. Vedi Webhook.
Spegni le vecchie chiamate quando nessuna risposta porta più l’header Sunset.

Contratti collegati a un’altra piattaforma

Se la tua piattaforma usa il contratto di un’altra piattaforma Spedisci.online tramite chiave API, anche quel collegamento va portato sulla nuova versione entro la stessa data. La procedura è descritta in Collegamento Spedisci.online.