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 nous transférer les commandes des 3 derniers mois pour collecter des avis pertinents.
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 permettant de créer votre compte API.
- Une fois le compte créé, vous pouvez visualiser vos paramètres API : URL, Identifiant site web et Clé secrète.
- Générez 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/realms/skeepers/protocol/openid-connect/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/realms/skeepers/protocol/openid-connect/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.
C'est ici, dans la partie Authentication que vous devrez ajouter l'identifiant de votre site web :
Retrouver les codes d'intégration
Pour retrouver votre clé secrète et l'identifiant de votre site web :
- Rendez-vous dans le menu latéral gauche d'Avis Vérifiés
Gestion du compte, puis
Mon compte.
- Les informations se trouvent alors à droite de la page dans la partie Code d'intégration.
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.
Pour cela, rendez-vous dans le menu latéral gauche Collecte des avis, puis Suivi des demandes d'avis
Si vous souhaitez collecter uniquement des avis marque, vous devez retirer la variable produit de votre appel API.
En savoir plus dans la documentation API : Submit Purchase Event > Sollicitation_parameters > purchase_event_type.