Uso de Postman para los modelos de la API del colaborador comercial
Uso de Postman para los modelos de la API del colaborador comercial
En este documento se explica cómo configurar y usar {{0}} para los modelos de la API del colaborador comercial (SP-API). Puedes utilizar {{1}} para generar tokens de acceso de Iniciar sesión con Amazon (LWA), importar modelos de la SP-API, realizar llamadas a endpoints de la SP-API y realizar llamadas a endpoints del entorno aislado de la SP-API.
Credenciales necesarias para realizar una llamada
client_id
yclient_secret
de LWA. Obtendrás estas credenciales después de registrar tu aplicación. Consulta Cómo ver la información y las credenciales de tu aplicación para obtener más información.- Token de actualización de LWA. Recibirás tu token de actualización de LWA después autorizar su solicitud.
- Punto final SP-API. Consulte Puntos finales de SP-API para obtener más información.
Genere un token de acceso de inicio de sesión con Amazon (LWA) mediante Postman
Iniciar sesión con Amazon (LWA) permite a los clientes de Amazon iniciar sesión en sitios web o aplicaciones móviles externos registrados ("aplicaciones cliente") con su nombre de usuario y contraseña de Amazon. Las aplicaciones cliente pueden pedirles que compartan algunos datos personales de su perfil de Amazon, como el nombre, la dirección de correo electrónico y el código postal. Antes de poder usar {{0}} con los modelos de la SP-API, primero debes generar un token de acceso para autenticarte en la SP-API.
-
Abrir Cartero e inicia sesión en tu cuenta.
-
Para Workspaces, elige tu espacio de trabajo.
-
Elige New.
-
En el Create New cuadro de diálogo, elija HTTP Request.
-
Para Request, elige POST.
-
Copia y pega el siguiente enlace en el cuadro de texto.
https://api.amazon.com/auth/o2/token -
Elige el Authorization pestaña y para Type, elige No Auth.
-
Elige el Body pestaña y selecciona x-www-form-urlencoded.
-
En el Body tabla, añada los siguientes pares clave-valor:
Clave Value grant_type
refresh_token refresh_token
[el valor de tu token de actualización] client_id
[el valor de tu identificador de cliente] client_secret
[el valor de tu secreto de cliente] -
Elige Send.
La respuesta devuelve el token de acceso que se utiliza para autenticarse en la SP-API.
"access_token": "Atza|*****",
"refresh_token": "Atzr|*****"'
"token_type": "bearer",
"expires_in": 3600
Importación de un modelo SP-API a Postman
Antes de llamar a un endpoint de SP-API, debes importar el modelo de la SP-API a {{0}}.
-
Abre la carpeta selling-partner-api-models en GitHub.
-
En la lista de carpetas, busca y selecciona el modelo de API que deseas descargar y, a continuación, elige el archivo JSON.
-
En la vista de archivos JSON, elija Raw para ver el código fuente o selecciona el icono de descarga para descargar el archivo sin procesar.
-
Copia el código fuente del modelo.
-
Abre un editor de texto (como el Bloc de notas) y pega el texto del modelo. A continuación, guarda el archivo con la extensión ".json".
-
Inicia sesión en Postman.
-
Para Workspaces, elige tu espacio de trabajo.
-
Elige Import, selecciona tu archivo JSON y, a continuación, elige Open.
-
En el Import cuadro de diálogo, seleccione Postman Collection y elige Import.
Aparece un mensaje de éxito cuando el archivo se importa correctamente.
Llamar a un endpoint de la SP-API
-
Inicia sesión en Postman.
-
Para Workspaces, elige tu espacio de trabajo.
-
En el Collections pestaña, selecciona la API recién importada y elige
GET
operación. -
Si aún no lo has hecho, genera un token de acceso de LWA con Postman. Necesitarás un token de acceso de LWA para cambiarlo por un token de actualización.
-
En el Headers pestaña, añada el siguiente par de claves:
Clave Value x-amz-access-token
[el valor de tu token de acceso] -
Elige Send.
El texto de la respuesta se rellena en Response ventana.
Llamar a un endpoint del entorno aislado de la SP-API
El proceso para realizar llamadas a entornos aislados de la API del colaborador comercial es idéntico al de las llamadas de producción, excepto que las diriges a los endpoints de los entornos aislados de la API del colaborador comercial. La API del colaborador comercial ofrece dos entornos aislados que te permiten probar tus aplicaciones sin afectar a los datos de producción ni provocar eventos reales.
El entorno aislado estático de la API del colaborador comercial utiliza la coincidencia de patrones para devolver respuestas estáticas y simuladas. El entorno aislado dinámico de la API del colaborador comercial dirige las solicitudes a un backend de entorno aislado que puede devolver respuestas realistas en función de los parámetros de la solicitud.
Consulta Entorno aislado de la API del colaborador comercial para obtener más información.
-
Inicia sesión en Postman.
-
Importa el modelo Swagger de la API que estás utilizando a tu espacio de trabajo de https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/ordersV0.json. Por ejemplo, el modelo Swagger de la API de pedidos.
-
Para Workspaces, elige tu espacio de trabajo.
-
En el Collections pestaña, elige tu colección y elige la
GET
operación. Por ejemplo, si quieres probar una llamada a la API GET Orders, selecciona get Orders Llamada a la API. -
Configura
{{baseUrl}}
como Selling Partner API sandbox (Entorno aislado de la API del colaborador comercial). -
En la pestaña Params (Parámetros), pasa los valores de solicitud estáticos del modelo Swagger. Por ejemplo, la API de pedidos.
-
Al llamar a un endpoint de entorno aislado, tendrás que comprobar que tu solicitud incluya todos los parámetros necesarios tal como se definen en el modelo Swagger correspondiente. Consulta el siguiente ejemplo de un modelo Swagger de la API de pedidos v0, donde la llamada a la API Get Order se resalta con una respuesta correcta:
-
Si aún no lo has hecho, genera un token de acceso de LWA con Postman. Necesitarás un token de acceso de LWA para cambiarlo por un token de actualización.
-
En el Headers pestaña, añada el siguiente par de claves:
Clave Value x-amz-access-token
[el valor de tu token de acceso] -
Elige Send.
-
Comprueba que la respuesta devuelva una carga útil que coincida con el modelo Swagger.
El texto de la respuesta se rellena en Response ventana.
Updated 23 days ago