Creazione di solide applicazioni Amazon SP-API
Crea solide applicazioni API per i partner di vendita.
Le tue applicazioni client SP-API devono gestire le modifiche ai report e agli elementi di risposta restituiti da SP-API, anche senza previa notifica da Amazon.
Modifiche ai report restituiti da SP-API
Crea parser di report nelle tue applicazioni client in grado di gestire i seguenti tipi di modifiche ai report restituiti da SP-API:
- Nuovi campi nei report. Le applicazioni client devono gestire i nuovi campi nei report non appena disponibili. Questi includono nuove colonne nei report in formato file di testo e nuovi elementi nei report XML.
- Nuovi valori dei campi nei report. Le applicazioni client devono gestire i nuovi valori dei campi nei report non appena disponibili. Questi includono nuovi valori di colonna nei report in formato file di testo e nuovi valori di elemento nei report XML.
Integrare la gestione degli errori se si utilizzano report xSD
Se scegli di utilizzare gli xSD dei report pubblicati da Amazon per convalidare i report restituiti da SP-API, assicurati di inserire la gestione degli errori nella tua logica di convalida. Qualsiasi convalida dei report inclusa nell'applicazione client dovrebbe essere in grado di gestire nuovi elementi di risposta o valori degli elementi di risposta non riconosciuti.
Modifiche agli elementi di risposta SP-API
Crea le tue applicazioni client per gestire con garbo i seguenti tipi di modifiche alle risposte SP-API:
- Nuovi elementi di risposta. Le applicazioni client dovrebbero gestire nuovi elementi di risposta non riconosciuti.
- Nuovi valori degli elementi di risposta. Le applicazioni client dovrebbero gestire nuovi valori degli elementi di risposta non riconosciuti.
Best practice
- Aspettati dei cambiamenti. Assicurati che le applicazioni client non si interrompano quando Amazon introduce nuovi elementi di risposta, valori degli elementi di risposta, campi di report o valori dei campi di report. Non codificare le applicazioni client in modo che si aspettino solo determinati elementi, campi o valori.
- Registra elementi, campi o valori non riconosciuti. Conserva un registro di tutti gli elementi, campi o valori non riconosciuti restituiti da SP-API. Puoi utilizzare questo registro per segnalare le nuove funzionalità introdotte da Amazon e quindi aggiornare l'applicazione client per sfruttare questa funzionalità.
- Visualizza elementi, campi o valori non riconosciuti. Se SP-API inizia a restituire un report con un nuovo campo, ad esempio, potresti escogitare un modo per far apparire automaticamente i nuovi valori dei campi nell'applicazione client in modo utile per i tuoi utenti.
- Aspettati elementi di risposta in qualsiasi ordine. Gli elementi di risposta possono essere restituiti in qualsiasi ordine all'interno di una struttura. Assicurati che le applicazioni client non dipendano dall'ordine in cui gli elementi di risposta vengono restituiti da SP-API.
- Usa la versione più recente del modello. Per prevenire
null
valori enum, usa la versione più recente del modello API.
Updated 3 months ago