Creating an API by Importing an API from a URL
You must have the API Gateway's manage APIs or activate/deactivate APIs functional privilege assigned to perform this task.
To create an API by importing an API from a URL
1. Click APIs in the title navigation bar.
A list of available APIs appears.
2. Click Create API.
3. Select Importing API from URL.
4. Type the URL from where the API is to be imported.
5. Select Protected to make the API a protected API.
6. Type a name for the API name in the Name field.
If you provide an API name, this overwrites the API name mentioned in the uploaded file and the API is displayed with the name provided.
If you do not provide an API name, the API name mentioned in the uploaded file is picked up and the API is displayed with that name.
If you do not provide an API name and the uploaded file does not have an API name mentioned, then the API is displayed as Untitled.
7. Provide a description for the API in the Description field.
8. Select the required type.
The available types are RAML, Swagger, WSDL, and OData.
9. Provide a version for the API in the Version field.
10. Select the team to which the API must be assigned in the Team field.
This field appears only when the Team feature is enabled. It displays only the teams that you are a part of. If you have the User management functional privilege, all teams are displayed. You can select more than one team. To remove a team, click the
icon next to the team to be removed.
11. Click Create.
Note:
Importing an API fails for an invalid WSDL file.
Creating an API by importing swagger files from an HTTPS URL that is using self-signed certificates may fail. To workaround this, you can set the system environment variable as:
export TRUST_ALL=true, so that the invalid certificates are ignored. Be aware that setting this variable makes the swagger-parser ignore all invalid certificates too. So this workaround has to be used with caution.
To avoid encountering errors while parsing large responses from the native service, you have to change the enablesoapValidation property by commenting out the
<parameter name="enableSoapValidation">true</parameter> in
Sagroot_Installdir\IntegrationServer\instances\default\config\wss\axis2.xml and restart the server for the change to take effect.