Utilizando Postman para Selling Partner API models

Utilizando Postman para Selling Partner API models

Import an SP-API model into Postman

  1. Ve a la página del Selling Partner API Model’s page.
  2. Navega hasta la API que deseas descargar y haz clic en el icono del clipboard para copiar el modelo.
  3. Abre un editor de texto (como Notepad) y pega el texto del modelo. Luego, guarda el archivo.
  4. Abre Postman e importa el archivo .json.

Importing video thumbnail


Genere un token de acceso LWA usando Postman

  • Realiza una llamada POST a https://api.amazon.com/auth/o2/token.
  • Haga clic en la pestaña Body, seleccione x-www-form-urlencoded y agregue los valores grant type, refresh token, client_id y client_secret. Puede obtener el client_id y client_secretdespués de registrar su aplicación.
  • Haz clic en Send.

La respuesta devolverá el token de acceso (Access Token) que puedes utilizar para autenticarte en SP-API.

LWA Access Token thumbnail


Solicitar AWS STS y generar credenciales temporales utilizando Postman.

Security Token Service (STS) es un servicio web que te permite solicitar credenciales temporales con privilegios limitados para usuarios de AWS Identity y Access Management (IAM) o para usuarios a los que autentiques usuarios federados (federated users).

Este paso es requerido si tu ID de aplicación está asociado con un IAM role.

Generate temp credentials thumbnail

GET AWS STS solicitud

  1. Inicia sesión en Postman.
  2. Selecciona New.
  3. Selecciona HTTP Request.
  4. En el drop-down de la izquierda, elige GET.
  5. Copia y pega el siguiente link en el cuadro de texto:
    https://sts.amazonaws.com/?Version=2011-06-15&Action=AssumeRole&RoleSessionName=Test&RoleArn=arn:aws:iam::XXXXXXXXXXXX:role/SellingParSellingPart&DurationSeconds=3600
    Reemplaza arn:aws:iam::XXXXXXXXXXXX:role/SellingParSellingPart con el ARN de tu cuenta.
  6. En la pestaña Authorization, en la sección Type, elige AWS Signature.
  7. Agrega tu AccessKey y SecretKey de AWS.
  8. Agrega el Service name como sts.
  9. Selecciona Send.

Post AccessToken

  1. Selecciona la pestaña POST y en el drop-down de la izquierda, elige POST.
  2. Copia y pega el siguiente link en el cuadro de texto:
    https://api.amazon.com/auth/O2/token
  3. En la pestaña Authorization, en la sección Type, elige No Auth.
  4. En la pestaña Body, selecciona x-www-form-urlencoded y luego ingresa tus credenciales.
  5. Selecciona Send.

Realizar una llamada a un SP-API endpoint

Por ejemplo, puedes realizar una llamada GET a https://sellingpartnerapi-na.amazon.com/sellers/v1/marketplaceParticipations desde la Seller API.

  1. Importa sellers.json para crear la collection de Postman de la Sellers API.
  2. Selecciona get Marketplace Participations.
  3. En la pestaña Authorization , agrega el AccessKey, Secretkey, y AWS Region.
  4. Agrega elServiceName como execute-api.
  5. En la pestaña Headers , agrega el valor x-amz-access-token que recibiste en el paso " Genere un token de acceso LWA usando Postman" o "Solicitar AWS STS y generar credenciales temporales utilizando Postman."para realizar la llamada correctamente.

Make a call to endpoint thumbnail


Realiza una llamada a un endpoint de sandbox (entorno de pruebas).

  • Puedes consultar los endpoints de sandbox (entorno de pruebas) de SP-API en la Selling Partner API desarrollador Guide.
  • Llamar a los endpoints de sandbox (entorno de pruebas) de SP-API es similar a realizar una llamada a SP-API. El endpoint es diferente para sandbox (entorno de pruebas) y los datos devueltos coincidirán con la respuesta del objeto de sandbox (entorno de pruebas) correspondiente a esa API si se agregan todos los parámetros requeridos y la solicitud es válida.

Make a call to sandbox thumbnail