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 |
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)
✨ Nouvelle Plateforme
Prérequis
- Nous vous conseillons de récupérer les commandes des derniers trois mois pour collecter des avis pertinents.
- Avoir souscrit à la solution Avis Vérifiés après septembre 2022
Configuration
-
Rendez-vous dans le menu latéral gauche
Collecte des avis, puis Configuration
- Choisissez alors API dans le bandeau de configuration
- Cliquez sur le bouton vous permettant de 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 alors votre clé secrète en cliquant sur Voir la clé
En cas de problème, vous pourrez à nouveau générer cette clé.
Structurer et envoyer la requête
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.
https://auth.skeepers.io/am/oauth2/alpha/access_token
-
Authorization: Set to
Basic <base64 encoded "clientId:clientSecret"> -
Content-Type: Set to
application/x-www-form-urlencoded
-
grant_type: Set to
client_credentials -
scope: Set to
openid
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"
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 la collecte
Vous avez la possibilité de vérifier la transmission et l'intégration de vos preuves d’achat/service ainsi que l'état de la demande d'avis depuis.
Pour cela, rendez-vous dans le menu latéral gauche Collecte des avis, puis Suivi des demandes d'avis
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 :