Como criar aplicativos robustos da SP-API da Amazon
Crie aplicativos robustos da API do parceiro de vendas.
Os aplicativos do cliente da SP-API devem lidar com alterações nos relatórios e elementos de resposta que a SP-API retorna, mesmo sem notificação prévia da Amazon.
Alterações nos relatórios retornados pela SP-API
Crie analisadores de relatórios em seus aplicativos do cliente que possam lidar com os seguintes tipos de alterações nos relatórios retornados pela SP-API:
- Novos campos nos relatórios. Os aplicativos do cliente devem lidar com novos campos nos relatórios à medida que eles se tornam disponíveis. Isso inclui novas colunas em relatórios de arquivo simples e novos elementos em relatórios XML.
- Novos valores de campo nos relatórios. Os aplicativos do cliente devem lidar com novos valores de campo nos relatórios à medida que eles se tornam disponíveis. Isso inclui novos valores de coluna em relatórios de arquivo simples e novos valores de elementos em relatórios XML.
Tratamento de erros integrado se você usar XSDs de relatório
Se você optar por usar XSDs de relatório publicados pela Amazon para validar relatórios retornados pela SP-API, certifique-se de incorporar o tratamento de erros à lógica de validação. Qualquer validação de relatório incluída no aplicativo do cliente deve ser capaz de lidar com elementos de resposta ou valores de elementos de resposta novos e não reconhecidos.
Alterações nos elementos de resposta da SP-API
Crie seus aplicativos do cliente para lidar corretamente com os seguintes tipos de alterações nas respostas da SP-API:
- Novos elementos de resposta. Os aplicativos de cliente devem lidar com elementos de resposta novos e não reconhecidos.
- Novos valores dos elementos de resposta. Os aplicativos do cliente devem lidar com valores de elementos de resposta novos e não reconhecidos.
Práticas recomendadas
- Prepare-se para mudanças. Garanta que os aplicativos de cliente não falhem quando novos elementos de resposta, valores de elementos de resposta, campos de relatório ou valores de campo de relatório forem introduzidos pela Amazon. Não codifique os aplicativos de cliente de modo a esperar apenas por determinados elementos, campos ou valores.
- Registre elementos, campos ou valores não reconhecidos. Mantenha um registro de todos os elementos, campos ou valores não reconhecidos retornados pela SP-API. Você pode usar esse registro para sinalizar uma nova funcionalidade introduzida pela Amazon e, em seguida, atualizar o aplicativo do cliente para aproveitar essa funcionalidade.
- Revele elementos, campos ou valores não reconhecidos. Se a SP-API começar a retornar um relatório com um novo campo, por exemplo, você poderá criar uma maneira de exibir automaticamente os novos valores de campo no aplicativo do cliente de forma útil para os usuários.
- Espere que os elementos de resposta apareçam em qualquer ordem. Os elementos de resposta podem ser retornados em qualquer ordem dentro de uma estrutura. Certifique-se de que os aplicativos de clientes não dependam da ordem em que os elementos de resposta são retornados pela SP-API.
- Use a versão mais recente do modelo. Para evitar
null
valores enum, use a versão mais recente do modelo de API.
Updated 3 months ago