Configure an external API
In this topic, you learn how to configure an API to communicate with an API outside DXP - Open Edition.
Procedure
| In this procedure we use sample data from the Star Wars universe. You can exchange our data with your data in the procedure. |
-
In the Cockpit, go to Connectivity and select API Designer.
-
In the API Designer, select Add.
Result: The API configuration window opens. You start in the General tab.
-
In Type, select External.
-
In API format, Swagger 2.0 is preselected. You can select the newer version, Open API 3.0, here.
-
Enter a Name for your external API.
-
If you have created a development dackage or connectivity group for your APIs, you can select those from the Group or Package drop-down menu.
-
Enter a short and meaningful Description to your API.
-
In Version, enter a version number, for example,
1.0, to keep track of changes to the API. -
In Endpoint, enter the URL of the external API, for example,
https://swapi.dev/api.Do not put a slash /at the end of the endpoint. -
In Media Type, define the type of content of your API. This is needed to communicate with your browser. By default, it is
application/json. -
Activate any of the following options that fit your application:
- Allow Untrusted Certificates
-
Allowing SSL/TLS certificates from servers that may not be considered "trusted".
- Enable Proxy
-
Allow proxy to reach external servers to prevent CORS issues.
- Restrict Access
-
Restrict access to all operations. This can only be accessible when Enable Proxy is enabled.
- Enable Trace
-
Allow tracing activities of your API. You can see activities in the API Trace.
- Use in App Designer & App Editor
-
Allow this API to be used in the App Designer or App Editor.
-
Select Save.
Results
-
Your API is saved with the current settings and is added to the library in the API Designer.
-
The API Designer adds an ID to your API and saves change dates.