Send Requests

Use these guidelines when sending requests using the IAM REST API.

URL Structure

Here's the URL structure for the requests:

https://<IAM_IP>/console/auth/realms/sbc/protocol/openid-connect/token
Where:
  • <IAM-IP>: specifies either IAM IP address or IAM FQDN

Supported Methods

You can perform basic CRUD operations on a resource by using standard HTTP method requests, as summarized in the following table.

HTTP Method Description
POST Request an access or refresh token.

Media Types

The following media types are supported by the IAM REST API:

  • application/json

Supported Headers

The IAM REST API supports the following headers that may be passed in the header section of the HTTP request or response.

Header Description Example
Content-Type Media type of the body of the request. Required for POST requests.
  • Content-Type: application/json
Authorization

When requesting the access token, the request body should contain the credentials to access the IAM.

When sending the access token, this header's value is the word "Bearer" followed by the previously returned access token.

Requesting a token: The request token can be obtained using the IAM API.

Sending a token:

Authorization: Bearer <token value>