Automation Method: send my orders through API

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:


mceclip0.png

 

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).

 

mceclip1.png

 

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.

 

Was this article helpful?
2 out of 3 found this helpful