Token API

The token API is for requesting access tokens issued by our IoT identity provider.

Token Endpoint

Use this endpoint to request a new access token by authenticating with a private key JWT.

For additional details about the JWT visit our developer guide.

Request a token

POST coaps://iot-idp.demo.coap-apps.iothentix.io/as/token

Request an access token by authenticating with a signed JWT.

Request Body

Name	Type	Description
client_id*	String	Client ID of the registered OAuth client.
scope	String	Request a scope to be present in the access token.
client_secret*	String	Private key JWT.

201: Created Successful token request

{
  "access_token": "<ACCESS_TOKEN>"
}

401: Unauthorized The private key JWT was missing.

{
    "error":"UNAUTHORIZED",
    "error_uri":"iot-idp.demo.apps.iothentix.com",
    "error_description":"The request could not be authorized"
}

400: Bad Request The request format was incorrect.

// Some code

500: Internal Server Error Internal error in the IdP infrastructure.

{
    "error": 
    {
        "code": 500,
        "status": "Internal Server Error",
        "request": "<REQUEST_ID>",
        "message": "An internal server error occurred, please contact the system administrator"
    }
}

403: Forbidden The private key JWT was invalid.

{
    "error": "FORBIDDEN",
    "error_uri": "iot-idp.demo.apps.iothentix.com",
    "error_description": "The requested action was forbidden"
}

405: Method Not Allowed The requested method is not allowed for this resource.

Renew Token Endpoint

Use this endpoint to renew the access token based on a previously issued access token.

Refresh the token

POST coaps://iot-idp.demo.coap-apps.iothentix.io/as/renew/token

Request a new access token by authenticating with a previously issued access token.

Request Body

Name	Type	Description
client_id*	String	Client ID of the registered OAuth client
token*	String	Access token issued by the IoT provider

201: Created Successful token refresh request

{
  "access_token": "<ACCESS_TOKEN>"
}

400: Bad Request

{
    // Response
}

500: Internal Server Error Internal error in the IdP infrastructure.

{
    "error": 
    {
        "code": 500,
        "status": "Internal Server Error",
        "request": "<REQUEST_ID>",
        "message": "An internal server error occurred, please contact the system administrator"
    }
}

403: Forbidden

{
    "error": "FORBIDDEN",
    "error_uri": "iot-idp.demo.apps.iothentix.com",
    "error_description": "The requested action was forbidden"
}