1. Log in to the Kuika platform and open the project you’ll be working on from the Apps screen.
2. Open the Datasources module from the top menu. In this module, you can view the data sources and actions in your app under the Recently modified and Data sources tabs, search using the Search by name field, and add a new data source.
3. Click the Create an API card at the top of the screen. This card allows you to create Swagger, REST, OData, SAP, and MQTT broker connections.
4. In the list that opens, select the Swagger API (OpenAPI/Swagger specification) option under the APIs & Services heading. You can use the ↑/↓ keys to navigate the list and the Enter key to make a selection.

5. Enter a name for your data source in the Name field (e.g., userguideswagger).
6. Click the CREATE button to complete the process. To cancel the operation, use the CANCEL button; to return to the connection type selection, use the < Swagger API link.

Note: You can also start the process of adding a new data source using the + icon next to the Sources heading in the left panel.

A. Top Menu

• Back Button (←): Takes you back to the Datasources screen.
• Data Source Name: Displays the name of the Swagger API data source you created (e.g., userguideswagger). Use the dropdown arrow next to it to switch between data sources, or the pencil icon to edit the name.
• CREATE Button: Saves the connection settings and closes the screen.

B. 01 Endpoint

Contains the service information that Kuika will connect to.

• Swagger URL (required): This is the URL of the Swagger API’s JSON definition file. Example: https://petstore.swagger.io/v2/swagger.json
• Service base URL (required): The API’s base service URL. Example: https://petstore.swagger.io/v2

Hover over the (i) icons next to the fields to view descriptions of the fields.

C. 02 Authentication

Determines how Kuika will authenticate itself to the API.

• Authentication type: This field allows you to select the authentication type for API access. Options include No Auth, Bearer, Basic, and API Key.
• Header Table: Consists of the Type, Key, and Value columns. The required rows are automatically added to the table based on the selected authentication type. You can define optional additional fields using rows of the Custom type.

D. Right Panel

• Description: This is the field where you can add notes about the Swagger API.
• Learn More: You can access the relevant documentation via the Swagger API user guide link.
• After You Create: This indicates that clicking the CREATE button saves the link and closes this screen.

1. In the Endpoint section, enter the Swagger URL and Service base URL information.
2. In the Authentication section, select the authentication type from the Authentication type field and fill in the relevant fields.
3. If necessary, add Custom rows to the header table.
4. If you wish, enter a note about the data source in the Description field.
5. Click the CREATE button in the upper right to save the settings.

Swagger API Authentication Types

1. No Auth

Used for services that do not require authentication. No additional configuration is required; if you wish, you can define additional fields using the Custom row in the header table (see swagger_4.png).

2. Bearer

1. Select the Bearer option from the Authentication type field.
2. Kuika adds a row of type Username to the header table by default. The value of this row is fixed as {CurrentUserName} and represents the name of the user logged into the application; you can enter the header name to which this value will be sent in the Key field.
3. You can add custom parameters using Custom rows.
4. Enter the parameter information in the Key and Value fields (e.g., Key: client_id, Value: your_client_id).
5. Click the CREATE button to save.

3. Basic

1. Select the Basic option from the Authentication type field.
2. Enter the Username and Password information. You can show or hide the password using the eye icon.
3. Verify that a locked row of type Basic Auth., with the Authorization key and the value {BasicAuthToken}, has been automatically added to the header table. This row sends the token generated from the information you entered.
4. You can add custom parameters using Custom rows.
5. Click the CREATE button to save.

4. API Key

1. Select the API Key option from the Authentication type field.
2. Enter the following information:
   
   • ID key name: The key name representing the client ID (e.g., client_id).
   • ID: The client ID.
   • Secret key name: The key name representing the client secret (e.g., client_secret).
   • Secret: The client secret. You can show or hide the value using the eye icon.
3. Custom lines allow you to add custom parameters.
4. Click the CREATE button to save.

By following these steps, you can integrate the Swagger API data source into your Kuika applications.