Authentication

An access token is obtained by making a POST request to the token endpoint at https://api.kiiaccess.se/auth/v1/token.

Appliance Owner Scope

Each access token is scoped to a specific appliance owner. This means that an access token must be obtained for each appliance owner you want to operate on behalf of as an integrator. To request an access token you first need to get an access key that gives authorization to the appliance owner integration. The access key can be obtained in the administration portal.

Request Parameters

The following parameters must be included in the request payload when requesting an access token:

grant_type - Must be client_credentials. client_id - The Client Id provided to your integration app. client_secret - The Client Secret provided to your integration app. appliance_owner_scope - The access key provided by the integration between you and an appliance owner.

Example

curl

curl --location --request POST 'https://api.kiiaccess.se/auth/v1/token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "grant_type":"client_credentials",
    "client_id":"<your-client-id>",
    "client_secret":"<your-client-secret",
    "appliance_owner_scope": "<your-access-key>"
}'