Skip to main content

Oltre all'autenticazione, ci sono altre modifiche che comportano incompatibilità con le versioni precedenti nei nuovi endpoint?

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.

Chi siamo

Il Portale per gli sviluppatori Shell supporta i partner nell'integrazione con le API Shell e nella trasformazione delle idee in soluzioni pronte per la produzione.

Logo Shell

Contatto

Accedere al proprio account

Chiedi all'assistente AI informazioni sulle API e sui prodotti API di Shell