Creación de aplicaciones robustas de Amazon SP-API

Sus aplicaciones cliente de SP-API deben gestionar los cambios en los reportes y los elementos de respuesta que devuelve SP-API, incluso sin notificación previa de Amazon.

Cambios en la respuesta de Reportes por SP-API

Cree analizadores de reportes en sus aplicaciones cliente que puedan manejar los siguientes tipos de cambios en los reportes que returns SP-API:

• Nuevos campos en los reportes. Sus aplicaciones cliente deben manejar nuevos campos en los reportes a medida que estén disponibles. Estos incluyen nuevas columnas en reportes de archivos planos y nuevos elementos en XML reportes.
• Nuevos valores de campo en los reportes. Sus aplicaciones cliente deben manejar nuevos valores de campo en los reportes a medida que estén disponibles. Estos incluyen nuevos valores de columna en reportes de archivos sin formato y nuevos valores de elementos en XML reportes.

📘

Incorpore el manejo de errores si usa reportes XSD

Si elige usar los reportes XSDs publicados por Amazon para validar los reportes returned por SP-API, asegúrese de incorporar el manejo de errores en su lógica de validación. Cualquier validación de reporte incluida en su aplicación de cliente debería poder manejar elementos de respuesta o valores de elementos de respuesta nuevos y no reconocidos.

Cambios en los elementos de respuesta de SP-API

Cree sus aplicaciones cliente para manejar correctamente los siguientes tipos de cambios en las respuestas de SP-API:

• Nuevos elementos en la respuesta. Sus aplicaciones cliente deben manejar elementos de respuesta nuevos y no reconocidos.
• Nuevos valores en los elementos de respuesta. Sus aplicaciones cliente deben manejar valores de elementos de respuesta nuevos y no reconocidos.

Mejores prácticas

• Espera cambios. Asegúrese de que las aplicaciones de sus clientes no se rompan cuando Amazon introduzca nuevos elementos de respuesta, valores de elementos de respuesta, campos de reporte o valores de campo de reporte. No codifique sus aplicaciones cliente para esperar solo ciertos elementos, campos o valores.
• Registrar elementos, campos o valores no reconocidos. Mantenga un registro de todos los elementos, campos o valores no reconocidos devueltos por SP-API. Puede usar este registro para marcar la nueva funcionalidad que ha introducido Amazon y luego actualizar su aplicación cliente para aprovechar esta funcionalidad.
• Mostrar elementos, campos o valores no reconocidos. Si SP-API comienza a devolver un reporte con un nuevo campo, por ejemplo, puede idear una forma de mostrar automáticamente los nuevos valores de campo en su aplicación cliente de una manera que sea útil para sus usuarios.
• Espere elementos de respuesta en cualquier orden. Los elementos de respuesta se pueden devolver en cualquier orden dentro de una estructura. Asegúrese de que sus aplicaciones cliente no dependan del orden en que SP-API devuelve los elementos de respuesta.