Importing APIs Definition

This article explains how to import APIs definitions can be imported from local files or URLs into the Element Repository to automatically create APIs and streamline API configuration.

You can import APIs into the Element Repository using following options:

• Plus (+) icon
• Ellipsis (...) icon

Importing APIs Definition using Plus icon

To Import APIs Definition in Element Repository using Plus (+) icon, perform the following actions:

1. On the Home page, under Projects, select the required Project.
2. Select Design Studio.
3. Select the Element Repository page
4. Select the Plus (+) icon.
5. Select Import APIs Definition. The Import APIs Definition dialog opens.

1. You can import API definition using the following options:

• File
• URL

File

To import an API definition using File option, perform the following actions:

1. In the Import APIs Definition dialog box, select the Upload JSON File button.

1. Select the appropriate JSON File from your local system.
2. Select the Import API to import the selected JSON File.
3. After the API definition is imported, it appears in the Element Repository page.

URL

To import an API definition using URL option, perform the following actions:

1. In the Source label text box, enter the API endpoint URL.
2. From the Protocol dropdown, select the required protocol.

Note:

• When using SOAP APIs, make sure to enter ?WSDL at the end of URL entered in Source label text box which automatically selects prototype as WSDL. For example: https://ecs.syr.edu/faculty/fawcett/code/calcWebService/Calc.asmx?WSDL
• When using REST APIs, Swagger protocol must be selected.

1. Select Import API button to import API Definition.

1. After the API definition is imported, it appears in the Element Repository page.

1. Select the send button to execute the imported API definition.

After executing the API request, you can go to Response tab to view the result.

1. Select the save button to store the configuration.

Importing APIs Definition using Ellipsis (...) Icon

To Import API Definition in Element Repository by selecting ellipsis (...) icon, perform the following actions:

1. In Element Repository page, select the parent folder in which you want to import the API definition.
2. Select the ellipsis (...) icon corresponding to that folder.
3. From the menu options, select Import Definition. The Import API Definition dialog box appears.

1. You can import API definition using the following options:

   • File
   • URL

File

To import an API definition using File option, perform the following actions:

1. In the Import API Definition dialog box, select the Upload JSON File button.
2. Select the appropriate JSON File from your local system.
3. Select the Import API to import the selected JSON File.
4. After the API definition is imported, it appears in the Element Repository page.

URL

To import an API definition using URL option, perform the following actions:

1. In the Source label text box, enter the API endpoint URL.
2. From the Protocol dropdown, select the required protocol.
3. Select Import API button to import API Definition.

Note:

• When using SOAP service, make sure to enter ?WSDL at the end of URL entered in Source label text box which automatically selects prototype as WSDL. For example: https://ecs.syr.edu/faculty/fawcett/code/calcWebService/Calc.asmx?WSDL
• When using Rest service, Swagger protocol must be selected.

1. After the API definition is imported, it appears in the Element Repository page.

1. Select the send button to execute the imported API definition.

After executing the API request, you can go to Response tab to view the result.

1. Select the save button to store the configuration as a APIs element.