API Reference
  • IoT IdP API Reference
  • Reference
    • HTTP API Reference
      • Token API
      • IdP API
      • Device API
    • CoAP API Reference
      • Token API
      • IdP API
      • Device API
Powered by GitBook
On this page
  • Token Endpoint
  • Request a token
  • Renew Token Endpoint
  • Refresh the token
  1. Reference
  2. CoAP API Reference

Token API

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

PreviousCoAP API ReferenceNextIdP API

Last updated 2 years ago

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 .

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.

{
  "access_token": "<ACCESS_TOKEN>"
}
{
    "error":"UNAUTHORIZED",
    "error_uri":"iot-idp.demo.apps.iothentix.com",
    "error_description":"The request could not be authorized"
}
// Some code
{
    "error": 
    {
        "code": 500,
        "status": "Internal Server Error",
        "request": "<REQUEST_ID>",
        "message": "An internal server error occurred, please contact the system administrator"
    }
}
{
    "error": "FORBIDDEN",
    "error_uri": "iot-idp.demo.apps.iothentix.com",
    "error_description": "The requested action was forbidden"
}

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

{
  "access_token": "<ACCESS_TOKEN>"
}
{
    // Response
}
{
    "error": 
    {
        "code": 500,
        "status": "Internal Server Error",
        "request": "<REQUEST_ID>",
        "message": "An internal server error occurred, please contact the system administrator"
    }
}
{
    "error": "FORBIDDEN",
    "error_uri": "iot-idp.demo.apps.iothentix.com",
    "error_description": "The requested action was forbidden"
}
developer guide