You have the possibility to send your proofs of purchase/service, in complete autonomy, thanks to the API automation method.
Click on the version corresponding to your menu:
| ✨ New Platform | 🖥️ Historical Platform |
✨ New Platform
Prerequisites
- We advise you to retrieve orders from the last three months in order to have relevant opinions.
- Have an account in the Verified Reviews by Skeepers solution
There are other automation methods like SFTP or CSV. (click on the desired method to know the process)
Process
Choose API method
- Go to the Collect reviews > Review sending menu:
Get the parameters to start building your queries
- Click on the button to create your API account
- Once the account is created, you can view your API settings (URL, identifier and secret key)
- Generate your secret key
How to generate your secret key?
Click on “View secret key” (If there is a problem, you can generate it again).
Structure and sending of the request
Authentication:
The Skeepers API uses OpenId Connect Client Credential grant to authenticate requests. In this grant a specific user is not authorized but rather the credentials are verified and a generic access_token is returned. This grant is used for machine to machine authentication.
Authentication 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”
Example:
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"
Purchase Event API swagger:
Please click on the Swagger link below to access the guide for setting up and simulating your proof of purchase or service requests.
https://apidocs.skeepers.io/purchase-events.html
Track your reviews collect from the review request follow-up page
You have the possibility to check the collect and integration of your proofs of purchase/service as well as the status of the review request from the tab Collect Reviews – Review Request follow-up
To collect only brand reviews, you need to remove the product variable from your API call.
🖥️ Historical Platform
Please forward the following documentation to your technicians.