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

https://auth.simplestore.io/connect/token

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
Request 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

Sample Object
{
"grant_type" : "client_credentials"
"client_id" : [from control panel]
"client_secret" : [from control panel]
}

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
Response Object

Element

Type

Description

access_token

string

A token

expiries_in

int

3600

token_type

string

"Bearer"

Sample Object
{
"access_token": "<Token>",
"expires_in": 3600,
"token_type": "Bearer"
}

Response: 400 Bad Request

Failed authentication will return invalid client

Response Object
Sample Object
Response Object

Element

Type

Desciption

error

string

error description

title

string

‚Äč

Sample Object
{
"error": "invalid_client"
}