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.

400: Bad Request The request format was incorrect.

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

403: Forbidden The private key JWT was invalid.

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

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

403: Forbidden