API Reference

This page will help you get started with obtaining an access token.

Log in to see full request history

To facilitate API interactions, we begin by retrieving the identification details through this initial operation. This is intended for server-to-server communication, with clients expected to make this request from their own server-side
environments.

To gain access to restricted resources and make authorized requests to our API, please proceed with acquiring an access token by completing the following steps.

1. Set the Request Details

  • URL: <https://public-gateway.aws.stg.mondia.io/api/marketplace/auth/token>

2. Add the Required Headers

HeaderValue
Content-Typeapplication/x-www-form-urlencoded
acceptapplication/json
x-api-keyknoditaaFTamoGzp36s5h9ikLMZbVKEaaGfd62EP

3. Prepare the Request Body

  • Using the following parameters, make a request against the auth/token endpoint:
    • grant_type: Set this to client_credentials.
    • client_id: Set this to the unique client Id provided to you from Mondia.
    • client_secret: Set this to the client secret provided to you from Mondia.
  • access_token: Cef215fd5-5cb2-4d2f-8bd0-e8463ff2a500.
Request BodyDescriptionRequired
grant_typeChoose from: client_credentials, user_credentials, refresh_token, authorization_codeYes
client_idA unique ID provided to youYes
client_secretThe client secret you receivedYes
codeFor the authorization_code grant typeNo
uuidFor user_credentialsNo
refresh_tokenFor the refresh_token grant typeNo

📘

Access Token

This initial access token is referred to as the "client_credentials".

Expiration Time: 7 days

HTTP Method: POST

URL: https://public-gateway.aws.stg.mondia.io/api/marketplace/auth/token

4. Make the Request

With your URL, header settings, and request payload in place, complete the API interaction by sending a POST request.

This step will return the access token necessary for logging in:

Keep this token safe, as it allows you to make authenticated requests until it expires.



Form Data
string
Defaults to client_credentials

The grant type. Values allowed are client_credentials, user_credentials, refresh_token & authorization_code

string
Defaults to 2101ddf1-79fd-4f17-a973-ef517bf094d0

Unique ID provided to the client

string
Defaults to 94f19851-79c8-4ce9-b4d5-471e08ac3c78

The client secret provided

string

Authorization code for 'authorization_code' grant type

string

User UUID for 'user_credentials' grant type

string

The refresh token for 'refresh_token' grant type

Responses

Language
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json