| Funzionalità | Precedente | Nuovo | Impatto |
|---|---|---|---|
| Meccanismo di autenticazione | Autenticazione di base (nome utente e password nelle intestazioni) | OAuth 2.0 (autenticazione basata su token) | Le integrazioni esistenti devono essere aggiornate per gestire la generazione e il rinnovo dei token. |
| ID richiesta obbligatorio | Facoltativo o non richiesto | RequestId è obbligatorio in ogni richiesta |
Tutte le applicazioni client devono generare e includere un ID richiesta univoco per ogni chiamata. |
| Conformità ai codici di stato HTTP | Codici di stato personalizzati o incoerenti | Codici di stato HTTP standard (ad es. 200, 400, 401, 500) | Potrebbe essere necessario rivedere la logica di gestione degli errori nelle app client. |
| Struttura uniforme di richiesta/risposta | Formati variabili tra gli endpoint | Struttura JSON standardizzata per tutte le API di lettura/scrittura | Potrebbe essere necessario aggiornare la logica di analisi e i modelli di dati nei sistemi client. |
| Payload di errore migliorato | Messaggi di errore minimi o generici | Struttura dettagliata degli errori con codici, messaggi e suggerimenti | I client dovrebbero aggiornare le routine di gestione degli errori per sfruttare i nuovi campi. |
| URL e parametri degli endpoint | Percorsi degli endpoint e nomi dei parametri legacy | Percorsi degli endpoint aggiornati e convenzioni di denominazione dei parametri | Tutti gli URL degli endpoint e i payload delle richieste devono essere rivisti e aggiornati. |
