Authentication

Generate access token using API secret Key

Register your application on Entity Studio Developer Dashboard and generate your API secret Key before proceeding.

Once the API secret key is generated, you can use the API below to generate a new access token. Just pass your API secret Key in X-Api-Secret-Key header to generate access token. The access_token is required to access all SSI APIs. Read the next section for more details.

Entity Studio SSI API base URL: https://api.entity.hypersign.id

POST/api/v1/app/oauth

Header parameters

Response

200400401

AccessToken generated

Body

application/json

access_token*string

accessToken

tokenType*string

Type of token

expiresIn*number

Token expiry time

Request

JavaScriptCurl

const response = await fetch('/api/v1/app/oauth', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6IjRkNjhmMjNmLTcwZjQtNDFhZC1hMGViLTU3MjA4YTZlOTcxMSIsImFwcFNlY3JldCI6IjNjN2NiNTY1LTZmNWQtNGY2MC1hMjQ2LTZhOGFjYWVhMmY0MyIsImdyYW50VHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImlhdCI6MTY3NDAyMDY3NCwiZXhwIjoxNjc0MDM1MDc0fQ.P-AbheTJMxQNGLTkGWOsnct4M0nKCd-7oUFGqMCpIDM",
  "tokenType": "Bearer",
  "expiresIn": 14400
}

Once you generated the access_token, you can pass this token as bearer authorization token in the header for all APIs.