Méthode d'automatisation : transmettre les commandes par API

Vous avez la possibilité d'envoyer vos preuves d'achat/service, en toute autonomie, grâce à la méthode d'automatisation API.

Cliquez sur la version qui correspond à votre menu :

✨ Nouvelle Plateforme 🖥️ Plateforme Historique

✨ Nouvelle Plateforme 

Prérequis

  • Nous vous conseillons de récupérer les commandes des derniers trois mois pour avoir des avis pertinents.  
  • Avoir un compte dans la solution Avis Vérifiés by Skeepers 
  • Avoir souscrit à la solution après septembre 2022

Il existe d'autres méthodes d'automatisation comme SFTP ou CSV. (cliquez sur la méthode souhaitée pour accéder à la procédure) 

Procédure 

Choisir méthode API :

  • Rendez-vous dans le menu Collecte d'avis > Envoi des demandes d'avis  
  • Choisissez API 

Récupérer les paramètres pour commencer à créer vos requêtes  

  • Cliquez sur le bouton pour créer votre compte API  
  • Une fois le compte créé, vous pouvez visualiser vos paramètres API ( URL, identifiant et clé secrète)  
  • Générez votre clé secrète  

Comment générer votre clé secrète ? 

Cliquez sur « Voir la clé secrète » (En cas de problème, vous pourrez la générer à nouveau).

Structurer et envoyer la requête  

Authentification 

L'API Skeepers utilise OpenId Connect Client Credential grant pour authentifier les requêtes. Dans cette autorisation, un utilisateur spécifique n'est pas autorisé, mais plutôt les informations d'identification sont vérifiées et un access_token générique est renvoyé. Cette autorisation (OpenId Connect Client Credential grant) est utilisée pour l'authentification de machine à machine.

 

Authentification URL

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

Header Parameter 

  • Authorization : Set to Basic <base64 encoded "clientId:clientSecret"> 
  • Content-Type: Set to “application/x-www-form-urlencoded” 

Request Parameter 

  • grant_type: Set to “client_credentials” 
  • scope: Set to “openid” 

Exemple: 

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" 

 

3.2 Purchase Event API swagger

Veuillez cliquer sur ce lien (Swagger)afin d’avoir accès au guide pour paramétrer et simuler vos requêtes de preuves d’achat ou prestation de service.  

 

Suivre votre collecte depuis la page Suivi de demande d’avis

Vous avez la possibilité de vérifier la récupération et intégration de vos preuves d’achat/service ainsi que l'état de la demande d'avis depuis l’onglet Collecte des avis – Suivi des demandes d’avis 

paint.jpg

Si vous souhaitez récolter uniquement des avis marque, vous devez retirer la variable produit de votre appel API.

🖥️ Plateforme Historique

Nous vous invitons à communiquer la documentation suivante à vos techniciens.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 3 sur 5