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

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 

🖥️ Plateforme Historique

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