Selling Partner API sandbox (entorno de pruebas)

El Selling Partner API proporciona dos sandbox (entorno de pruebas) que le permiten probar sus aplicaciones sin afectar los datos de producción ni desencadenar eventos del mundo real. El Sandbox(entorno de pruebas) estático de la Selling Partner API utiliza una técnica de coincidencia de patrones para devolver respuestas estáticas y simuladas. El Sandbox(entorno de pruebas) dinámico de la Selling Partner API redirige las solicitudes a un backend de sandbox (entorno de pruebas) que puede proporcionar respuestas realistas basadas en los parámetros de la solicitud.

Importante: Los sandbox (entorno de pruebas) son para probar la funcionalidad, no para probar la escalabilidad. Las llamadas a los sandbox (entorno de pruebas) endpoints están sujetas a estos límites de limitación: rate = cinco solicitudes por segundo; burst = 15. Para obtener más información sobre la limitación, Consulte Planes de uso y límites de tarifas en la Selling Partner API.

Contenido

• Sandbox(entorno de pruebas) estático de la Selling Partner API
• Sandbox(entorno de pruebas) dinámico de la Selling Partner API

Sandbox(entorno de pruebas) estático de la Selling Partner API

Hacer llamadas de sandbox (entorno de pruebas) al Sandbox(entorno de pruebas) estático de la Selling Partner API es idéntico a hacer llamadas de producción, excepto que usted dirige las llamadas a los extremos del Selling Partner API sandbox (entorno de pruebas) endpoints. Llamar a los sandbox (entorno de pruebas) endpoints devuelve respuestas estáticas y simuladas para todas las Selling Partner APIs. Puede hacer referencia a estas respuestas simuladas en el archivo JSON del modelo de Swagger para la API a la que desea llamar. Para obtener más información, consulta Cómo hacer una llamada estática al sandbox (entorno de pruebas) de la Selling Partner API.

El Sandbox(entorno de pruebas) estático de la Selling Partner API funciona como muchos marcos de burla, ya que utiliza la coincidencia de patrones para retornar una respuesta específica cuando los parámetros especificados están presentes. Un desarrollador recibe una respuesta definida en cualquiera de los siguientes objetos cuando envía una solicitud que incluye los parámetros especificados:

Objetos JSON de sandbox estático

"x-amzn-api-sandbox":
{
  "static": [
    {
      "request":
      {
        "parameters": 
        {
          …
        }
      },
      "response":
      {
        …
      }
    }
  ]
}

Tenga en cuenta que, si bien estos objetos contendrán los parámetros que se necesitan para hacer coincidir una mock response (respuesta simulada), no necesariamente contienen todos los parámetros que se requieren para una respuesta exitosa. Para obtener una respuesta exitosa, asegúrese de que su solicitud sea válida e incluya all required parameters(todos los parámetros requeridos) según lo definido en el Swagger model.

Cómo realizar una llamada de Sandbox(entorno de pruebas) estático de la Selling Partner API

Paso 1. Verifique el archivo JSON para los parámetros de solicitud.

1. Vaya a la página de Documentación.
2. En el panel de navegación izquierdo, encuentre la carpeta de la API para la cual desea hacer un sandbox (entorno de pruebas).
3. Elija el archivo JSON del Swagger model para la API que desee. Se muestra el código JSON.
4. Busca en el código un objeto x-amzn-api-sandbox que contenga un array "static".

Los objetos JSON del sandbox(entorno de pruebas) estático contendrán ejemplos de solicitudes y respuestas para llamadas del sandbox(entorno de pruebas) estático a la operación de la API en la que aparecen. Si el ejemplo de solicitud contiene parámetros, utilícelos en el paso siguiente.

Paso 2. Realice una llamada de Sandbox(entorno de pruebas) estática a una API

Realice una llamada de Sandbox(entorno de pruebas) estática a una API de la misma manera que haría una llamada de producción, con estas diferencias:

1. Incluya los parámetros del Paso 1. Verifique el archivo JSON para los parámetros de solicitud en su llamada. Si la API requiere parámetros adicionales, asegúrese de incluir también esos parámetros requeridos en su llamada.

2. Dirija su llamada a uno de los Selling Partner API sandbox endpoints.

   Debería recibir una respuesta que coincida con el objeto de payload contenido en el objeto JSON del sandbox(entorno de pruebas) estático del Paso 1.

Sandbox(entorno de pruebas) dinámico de la Selling Partner API

Hacer llamadas al Sandbox(entorno de pruebas) dinámico de la Selling Partner API es idéntico a hacer llamadas de producción, excepto que dirige las llamadas a los Selling Partner API sandbox endpoints. Las llamadas de sandbox dinámicas se envían (es decir, se reenvían) a un backend de sandbox (entorno de pruebas), que devuelve una respuesta adecuada según los parámetros de la solicitud. Debido a que no se limita a la coincidencia exacta de la búsqueda de patrones, puede realizar solicitudes y recibir respuestas que potencialmente tienen estado y reaccionan a la entrada. Por ejemplo, puede querer verificar los gastos de envío para diferentes direcciones de envío. Lo que puede hacer está limitado solo por las capacidades admitidas por el backend de sandbox (entorno de pruebas) proporcionado para esa sección de la API.

Puede determinar qué operaciones admiten llamadas Sandbox(entorno de pruebas) dinámico revisando el Swagger model JSON para la API a la que desea llamar. Una operación admite llamadas al Sandbox(entorno de pruebas) dinámico si la operación incluye el siguiente objeto:

"x-amzn-api-sandbox":
{
  "dynamic": {}
}

El objeto se puede encontrar en el nivel de operación o de ruta. Cuando se encuentra en el nivel de la ruta, todas las operaciones dentro de la ruta pueden realizar llamadas al Sandbox(entorno de pruebas) dinámico.

Cómo hacer una llamada de Sandbox(entorno de pruebas) dinámico a la Selling Partner API

Paso 1. Verifique el archivo JSON para operaciones que admitan llamadas Sandbox(entorno de pruebas) dinámico

1. Vaya a la página de Documentación.
2. En el panel de navegación izquierdo, busque la folder de la API para la que desea realizar una llamada de sandbox.
3. Elija el archivo JSON del Swagger model para la API que desee. Se muestra el código JSON.
4. Busque el código para:

"x-amzn-api-sandbox":
{
  "dynamic": {}
}

Si la operación contiene el objeto en el nivel de ruta o de operación,se admite el Sandbox(entorno de pruebas) dinámico.

Paso 2. Realice una llamada de Sandbox(entorno de pruebas) dinámico API

Realice una llamada de Sandbox(entorno de pruebas) dinámico API de la misma manera que haría una llamada de producción, excepto que dirija su llamada a uno de los Selling Partner API sandbox endpoints.

Operaciones exclusivas del sanbox (entorno de pruebas)

Los entornos de sandbox (entorno de pruebas) soportan APIs opcionales que son exclusivas del sandbox (entorno de pruebas) y solo pueden tener éxito cuando se dirigen a uno de los Selling Partner API sandbox endpoints. Puedes determinar qué operaciones son exclusivas de sandbox revisando el modelo JSON de Swagger para la sección API. Una operación que es exclusivas de sandbox (entorno de pruebas) contiene "x-amzn-api-sandbox-only": verdadero en el nivel de la ruta. Cuando se encuentra en el nivel de la ruta, todas las operaciones dentro de la ruta son solo exclusivas de sandbox (entorno de pruebas).

Las operaciones exclusivas de Sandbox complementan la API de producción para permitirle crear flujos de trabajo de prueba que no son posibles con las operaciones de la API de producción. Por ejemplo, podría tener un caso de uso en el que se crea una instancia de un elemento de datos a través de la interfaz de usuario, pero no a través de una API. Solo con fines de prueba, podría proporcionarse una API exclusiva de sandbox (entorno de pruebas) que crea el elemento de datos para permitir flujos de trabajo de prueba más completos.

Selling Partner API sandbox endpoints

La Selling Partner API tiene sandbox endpoints para las regiones de venta de América del Norte, Europa y el Lejano Oriente.