If you have an existing API definition in a file, you can import the API definition to quickly import multiple operations to the REST API on the REST API page.
When you import an API definition, you select the file that contains the definition, the URL that points to the definition, or APIs of IDMC services. You can import an API definition from the following sources:
•OpenAPI 3.0 JSON
•OpenAPI 3.0 YAML
•Swagger 2.0 JSON
•Swagger 2.0 YAML
After you specify the source file or URL, API Center parses the source and loads the operations. You select the operations to import.
Importing Application Integration processes to API Center
You can import all the Application Integration processes to API Center. The processes on the Service Name corresponds to the API Name and the Source Name corresponds to the Name in Application Integration.
This import capability helps you easily transition the REST APIs of published Application Integration processes into API Center. You can easily design, publish, and create managed APIs in API Center.
Importing an API definition
Import an API definition to the REST API on the REST API page.
1On the right panel of the REST API page, click Import an API Definition, or click Import.
2Select the API definition type to import. In the Source field, select one of the following source types:
- File. Select an API definition file from your local system.
- URL. Specify a URL that contains the location of the API definition file.
Note: If the URL points to a specification that requires authentication, you can't select the URL option. You must download the specification as a file by providing the authentication details, save it as local file, and then import it as a file.
- IDMC Services. Select the IDMC service from which you want to import the APIs.
3Click Next.
The Select Assets tab appears. API Center parses the file and displays the operations on the Select Operations tab. If there are any conflicts between the operations and the API, or any issue with the source file, API Center displays the warning details. Fix the API definition file and try again.
When you select Application Integration as the source, all published processes in Application Integration appear. You can filter the data by service name.
4Select the operations to import and click Next.
The Summary tab displays a summary of the assets that you selected.
5Click Import.
API Center imports the selected policies and operations. You can update the policies and operations if needed. For more information, see Creating an API operation.
6Click Save.
Importing and mapping an Application Integration process
You can import all the published REST APIs of Application Integration to API Center. You can import all published processes in Application Integration.
1On the right panel of the REST API page, click Import an API Definition, or click Import.
2Select the API definition type to import. In the Source field, select IDMC Services.
3Select Application Integration as the provider.
4Click Next.
In the Select Assets tab, all published processes in Application Integration appear. The list displays the service name, source name, status, protocol, and description of each published Application Integration process. You can filter the data by service name.
The following table shows the fields in API Center with their corresponding fields in Application Integration:
API Center Field
Application Integration Field
Source Name
Process Name
Service Name
API Name
Description
Description in the General tab of Start Properties.
5Select an asset to import and click Next.
You can select only one asset at a time.
The Summary tab displays a summary of the assets that you selected.
6Click Import.
API Center imports the selected assets and the related Swagger definitions from Application Integration and populates the operation metadata area.
The following table explains the correlation between the API Center and imported Application Integration assets:
API Center Tabs
Application Integration Field
Request method
Auto-populated from the Swagger definition.
Parameters
NA. Application Integration doesn't support any query or path parameters.
Request
All properties defined in the Input Fields of the Application Integration process. Required fields in Application Integration appear as True in API Center.
Response
All properties defined in the Output Fields of the Application Integration process.
Required fields in Application Integration appear as True in API Center.
Response headers present in Application Integration appear in API Center.
When you import an API definition with multiple response codes, you can view all the response codes. You can edit the response codes. However, you can't add any new response on the Response tab.
Implementation
The imported Application Integration process is already mapped and all the relevant fields are populated accordingly.
Policies
NA. API Center retains its default policy configurations.