Authentication and Authorization

Authentication

Endpointhttps://ilm-dev.dha.go.ke/uat-middleware/api/v1

Operations related to user authentication and token management.

Get access token

POST

https://ilm-dev.dha.go.ke/uat-middleware/api/v1

/tenants/token

Obtains an access token used for subsequent API calls

Related documentation: OAuth Flow, Authentication Best Practices

Get access token › Request Body

client_id

string · required

OAuth2 client ID. Example value is dummy data.

Example: hie-integrator-client

client_secret

string · required

OAuth2 client secret. Example value is dummy data.

Example: R4nd0m-Cl13nt-S3cr3t

Get access token › Responses

access_token

string

expires_in

integer

token_type

string

POST/tenants/token

curl --request POST \
  --url https://ilm-dev.dha.go.ke/uat-middleware/api/v1/tenants/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=hie-integrator-client \
  --data client_secret=R4nd0m-Cl13nt-S3cr3t

shell

Example Request Body

{
  "client_id": "hie-integrator-client",
  "client_secret": "R4nd0m-Cl13nt-S3cr3t"
}

json

Example Responses

{
  "access_token": "access_token",
  "expires_in": 0,
  "token_type": "token_type"
}

json

application/json

Authentication and Authorization

Authentication

Endpointhttps://ilm-dev.dha.go.ke/uat-middleware/api/v1

Operations related to user authentication and token management.

Get access token

POST

https://ilm-dev.dha.go.ke/uat-middleware/api/v1

/tenants/token

Obtains an access token used for subsequent API calls

Related documentation: OAuth Flow, Authentication Best Practices

Get access token › Request Body

client_id

string · required

OAuth2 client ID. Example value is dummy data.

Example: hie-integrator-client

client_secret

string · required

OAuth2 client secret. Example value is dummy data.

Example: R4nd0m-Cl13nt-S3cr3t

Get access token › Responses

access_token

string

expires_in

integer

token_type

string

POST/tenants/token

curl --request POST \
  --url https://ilm-dev.dha.go.ke/uat-middleware/api/v1/tenants/token \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data client_id=hie-integrator-client \
  --data client_secret=R4nd0m-Cl13nt-S3cr3t

shell

Example Request Body

{
  "client_id": "hie-integrator-client",
  "client_secret": "R4nd0m-Cl13nt-S3cr3t"
}

json

Example Responses

{
  "access_token": "access_token",
  "expires_in": 0,
  "token_type": "token_type"
}

json

application/json