Método de automatización: enviar mis pedidos a través de un API

Tienes la posibilidad de enviar tus comprobantes de compra/servicio, de forma totalmente autónoma, gracias al método de automatización API.

Haz clic en la versión correspondiente a tu menú:

✨ Nueva Plataforma 🖥️ Plataforma Histórica

 

Otros métodos de automatización, como SFTP o CSV, también están disponibles. (haz clic en el método deseado para acceder al procedimiento) 

✨ Nueva Plataforma 

Requisitos previos

  • Te recomendamos recuperar pedidos de los últimos tres meses para recolectar opiniones relevantes. 
  • Estás suscrito a la solución Opiniones Verificadas después de septiembre de 2022.

Configuración

  1. Ve al menú lateral Recogida de Opiniones, luego Configuración
  2. Selecciona API en la barra de configuración.
  3. Haz clic en el botón para crear tu cuenta API 
  4. Una vez creada la cuenta, puedes ver tu configuración API: URL, identificador y clave secreta.
  5. Genera tu clave secreta haciendo clic en Ver Clave.

Si tienes problemas, puedes regenerar esta clave.

Estructura y envía la solicitud  

Autenticación

La API de Skeepers utiliza OpenId Connect Client Credential grant para autenticar las solicitudes. Este método no autentica a un usuario específico, sino que verifica las credenciales y devuelve un access_token genérico.

Esta autorización (OpenId Connect Client Credential grant) se utiliza para la autenticación entre máquinas.

URL de autenticación

https://auth.skeepers.io/am/oauth2/alpha/access_token

Parámetro de cabecera
  • Authorization: Configura como Basic <base64 encoded "clientId:clientSecret">
  • Content-Type: Configura como application/x-www-form-urlencoded
Parámetro de solicitud
  • grant_type: Configura como client_credentials
  • scope: Configura como openid
Ejemplo

POST https://auth.skeepers.io/am/oauth2/alpha/access_token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64 encoded "clientId:clientSecret">

grant_type="client_credentials" & scope="openid"
      
API Swagger para eventos de compra

Haz clic en este enlace (Swagger) para acceder a la guía para configurar y simular tus solicitudes de prueba de compra o servicio.

Supervisar la recogida

Puedes verificar la transmisión e integración de tus pruebas de compra/servicio, así como el estado de las solicitudes de reseñas.

Para hacerlo, ve al menú lateral izquierdo Recogida de opiniones, luego Seguimiento de solicitudes de opinión.

Si deseas recoger únicamente reseñas de marca, necesitas eliminar la variable del producto de tu llamada a la API.

🖥️ Plataforma Histórica

Te invitamos a compartir la siguiente documentación con tus técnicos:

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 3 de 7