Creación de aplicaciones sólidas de la SP-API de Amazon

Cree aplicaciones API sólidas para socios vendedores.

Tus aplicaciones cliente de la SP-API deben gestionar los cambios en los informes y los elementos de respuesta que la SP-API devuelva, incluso sin notificación previa de Amazon.

Cambios en los informes devueltos por la SP-API

Crea analizadores de informes en tus aplicaciones cliente que puedan gestionar los siguientes tipos de cambios en los informes que devuelve la SP-API:

  • Nuevos campos en los informes. Las aplicaciones cliente deben gestionar los campos nuevos de los informes a medida que estén disponibles. Entre ellos se incluyen nuevas columnas en los informes de archivos sin formato y nuevos elementos en los informes XML.
  • Nuevos valores de campo en los informes. Tus aplicaciones cliente deben gestionar los nuevos valores de campo de los informes a medida que estén disponibles. Entre ellos se incluyen nuevos valores de columna en los informes de archivos sin formato y nuevos valores de elementos en los informes XML.

📘

Incorpora la gestión de errores si usas XSD de informes

Si optas por utilizar los XSD de informes publicados por Amazon para validar los informes devueltos por la SP-API, asegúrate de incorporar la gestión de errores en tu lógica de validación. Cualquier validación de informes incluida en la aplicación cliente debe poder gestionar elementos de respuesta o valores de elementos de respuesta nuevos y no reconocidos.

Cambios en los elementos de respuesta de la SP-API

Crea tus aplicaciones cliente para gestionar correctamente los siguientes tipos de cambios en las respuestas de la SP-API:

  • Nuevos elementos de respuesta. Tus aplicaciones cliente deben gestionar elementos de respuesta nuevos y no reconocidos.
  • Nuevos valores de elementos de respuesta. Tus aplicaciones cliente deben gestionar valores de elementos de respuesta nuevos y no reconocidos.

Prácticas recomendadas

  • Prepara tus aplicaciones para los cambios. Asegúrate de que tus aplicaciones cliente no se interrumpan cuando Amazon introduzca nuevos elementos de respuesta, valores de elementos de respuesta, campos de informe o valores de campos de informe. No codifiques tus aplicaciones cliente para que solo esperen determinados elementos, campos o valores.
  • Registra elementos, campos o valores no reconocidos. Mantén un registro de todos los elementos, campos o valores no reconocidos devueltos por la SP-API. Puedes usar este registro para marcar las nuevas funciones introducidas por Amazon y, a continuación, actualizar tu aplicación cliente para aprovechar esta funcionalidad.
  • Muestra los elementos, campos o valores no reconocidos. Si la SP-API comienza a devolver un informe con un campo nuevo, por ejemplo, podrías idear una forma de mostrar automáticamente los nuevos valores de campo en tu aplicación cliente de forma que resulte útil para los usuarios.
  • Espera elementos de respuesta en cualquier orden. Los elementos de respuesta se pueden devolver en cualquier orden dentro de una estructura. Asegúrate de que las aplicaciones cliente no dependan del orden en que la SP-API devuelva los elementos de respuesta.
  • Usa la última versión del modelo. Para prevenir null valores de enumeración, usa la versión más reciente del modelo de API.

¿Te ha ayudado esta página?