[]
        
(Showing Draft Content)

API Settings

As an admin at the Wyn Enterprise portal, you can configure URL, query param, HTTP header, and HTTP body in the API settings. The data monitor will use these API settings to send alerts. Let's see how to configure these settings.

Note: Currently the API settings are used in the data monitor only.

Configuring API Settings

You need to first Enable the API setting by selecting the Yes option and then click the Add API button to add the APIs.

apisetting-screen

Now you can add the APIs from the API Settings page.

api-settings-configurations

Note: Only Global Administrators and Organization Administrators can configure API Settings.

Complete the API Settings form as described in the table below.

API Setting

Description

API Name

Name of the API to be added. It should be a unique name.

Request Method

It has two options: Post and Put.

API Authorization

It supports three authentication methods: Basic, Password, and Client_credentials. Refer section below for details.

Url

It is a valid IP address or domain name.

Header

HTTP Header, Optional, you can configure the HTTP request headers required by the user, such as Authorization or Content-type. The name of the request header cannot be repeated. Currently, Wyn only supports requests with the Content-type as application/json, so you can fill in the Content-type as other types, but it has no effect.

Body

HTTP Body, Optional, you should fill in a valid JSON. If the Type is GET, Body input will disabled.

System Variable

The variables that can be added will be displayed in the drop-down box.

Test

Click the Test button for testing the API.

API Settings Based on Authorization Models

You can configure API settings based on the following Authorization methods: Basic, Password, and Client-credentials.

  1. On the API Settings page, in the field API Name, enter the name of the API to be added.

  2. Select the Request Method. In this example, we have selected the Post method.

  3. Click the API Authorization field.

    apiautedit-icon


    The Add Authorization dialog box is displayed.


    add-authorization-dialogbox


  4. Click the Auth Model dropdown list and Authorization models are displayed, as shown below.

    authorization-models-list

Select Client-credentials

select-client-credentials

The Add Authorization dialog box is displayed.

addauth-cliet-credentials

Complete the Client-credentials Settings as described below in the table.

Client-credentials Setting

Description

Auth Model

Selected authorization model. In this case, it is Client-credentials.

Token Endpoint

Request to get an access token.

Client Id

Client Id parameter specifies the public identifier for the user required for OAuth flows. It is fixed.

Client Secret

Client Secret parameter specifies a secret code used by the user to exchange an authorization code for a token. ClientSecret should be kept confidential.

Scope

Scope parameter is used to customize data requests to a third-party application.

created 2

5. Click the Save button. The Client_credentials are added.

6. Enter the Url and the Body and click the Test button.

7. Now, click the Add API button.

tested api

The API will be added.

API added

Similarly, you can add settings using the Basic and Password authorization models.

Select Basic

Select the Basic Auth model.

basic-authmodel

The Add Authorization dialog box is displayed.

add-auth-basic


Complete the Basic Settings as described below in the table.

Client-credentials Setting

Description

Auth Model

Selected authorization model. In this case, it is Basic.

UserName

API user's API username. This acts as an ID. It helps to authenticate each API operation.

Password

API user's API password. It helps to authenticate each API operation.

Select Password

Select Password as Auth model.

auth-model-password

The Add Authorization dialog box is displayed.

add-auth-password

Complete the Password Settings as described below in the table.

Password Setting

Description

Auth Model

Selected authorization model. In this case, it is Password.

Token Endpoint

Request to get an access token.

Client Id

Client Id parameter specifies the public identifier for the user required for OAuth flows. It is fixed.

Client Secret

Client Secret parameter specifies a secret code used by the user to exchange an authorization code for a token. ClientSecret should be kept confidential.

UserName

API user's API username. This acts as an ID. It helps to authenticate each API operation.

Password

API user's API password. It helps to authenticate each API operation.

You can use these APIs for Data Monitoring for sending notifications.

API on data monitoring