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

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

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

Element	Type	Desciption
error	string	error description
title	string

Sample Object

{
    "error": "invalid_client"
}