API Client Registration

Check out the given illustration to understand the API Client Registration functionality.

The API Client Registration option helps the user to register and save the specific details of API Clients. The API Client Registration form requires a specific data set link published as a service to complete the registration process.

• Navigate to the Admin Module.

• Click the Menu icon to open the admin menu panel.

• Click the API Client Registration option from the displayed menu panel.

• The API Client Registration page opens.

• Click the New option to create new client registration.

• The two Authentication types are available: Internal or External (The user can select any one of them).

Internal Client Registration

If Internal option is selected Authentication will happen from the platform side by using client id, client secret & app name.

• Select Internal as the authentication option.

• Provide the following information:

  • Client Name

  • Client Email

  • App Name

  • Request Per Hour

  • Request Per Day

  • Select API Type: Select either of the options: Data as API or Model as API

Please Note: Select API Type: The user can select any one of the given choices. Both Data as API & Model as API support Internal Authentication. So the user needs to select either one of them in Select API Type.

• After selecting one option from the Select API Type, the Select the Service Entitled field appears (The user can select multiple Data as API or Model as API by using this field).

• Click the Save option.

• A success message appears.

• The created API Client gets listed at the top of the displayed list.

The Internal API Client gets registered

Please Note:

• The client id and client secret will be automatically generated by the platform while saving the API Client Registration.

• Both Data as API & Model as API support Internal Authentication. So the user needs to select either one of them in Select API Type.

External Client Registration

The External option does not support Authentication by using client id, client secret, and app name. The user needs to authenticate by providing the secret Key and Values/Mapping key. The authentication will consider only if the selected Validation Type is Validated.

• Select the External option.

• Provide the following details:

  • Client Name

  • Client Email

  • Select the entitled services from the drop-down menu.

• Provide Key, Validation Type and Value/Mapping Key.

• Click the Save option.

Please Note: The Select the Services Entitled will display the data sets published as service from the Data Center module of the platform.

• A notification message appears.

• The API Client details get saved under the Client List.

How to call the API from POSTMAN

Internal Authentication API

• Click the Edit option for the saved API Client Registration.

• The API Client Registration form reopens.

• The user can get the Client Id, Client Secret, and App Name.

• Pass the Client id, Client Secret Key, and App Name in the Postman GET/ POST call to get the response.

External Authentication API

• Click on the Edit option for the saved API Client Registration.

• The API Client Registration form reopens.

• Select the entitled Service.

• The user can get the following information about the API Service:

  • Key

  • Validation Type

  • Value/ Mapping Key

• Pass these information in the Postman GET/POST call to get the response.