Simple Store
Search…
Backend APIs
The Simple Store Backend API support system to system integration to allow the building of complete applications using the Simple Store Platform. Example integrations include:
  • Server Side Framework (Spring/MVC) to Simple Store
  • Backend System (Order Management, Product Supplier) to Simple Store

Client Credential Authentication

SimpleStore platform uses bearer token to authenticate API requests. Using OAuth client credentials to authenticate the calling application and return a token that is valid for 60 minutes.
This token then used as a Bearer Token for subsequent API calls to the platform.
client_secretis sensitive information and it should never used or disclosed publicly.

Get an Access Token

This endpoint responsible in generating access tokens for Client (application) to allow full read and write access to the platform.

POST

1
https://auth.simplestore.io/connect/token
Copied!

Request: Headers

Key
Value
Content-Type
application/x-www-form-urlencoded

Request: Route

No Route

Request: Query

No Query

Request: Body

Request Object
Sample Object
Element
Type
Description
grant_type
string
"client_credentials"
client_id
string
Your client_id generated from Control Panel
client_secret
string
Your client_secret generated from Control Panel
1
{
2
"grant_type" : "client_credentials"
3
"client_id" : [from control panel]
4
"client_secret" : [from control panel]
5
}
Copied!

Response: 200 Ok

Successful authentication of client credentials will return access token with expiry time in seconds.
access_tokenhas an expiry of 60 minutes. You must renew the token on or before expiry.
Response Object
Sample Object
Element
Type
Description
access_token
string
A token
expiries_in
int
3600
token_type
string
"Bearer"
1
{
2
"access_token": "<Token>",
3
"expires_in": 3600,
4
"token_type": "Bearer"
5
}
Copied!

Response: 400 Bad Request

Failed authentication will return invalid client
Response Object
Sample Object
Element
Type
Desciption
error
string
error description
title
string
1
{
2
"error": "invalid_client"
3
}
Copied!