In this article
Overview
Proxy endpoints allow users to access your APIs and third-party APIs. You can define the HTTP methods for your endpoints and apply the appropriate authentication method.
You can:
Endpoint Certificates
Third-party endpoints often have unsigned, self-signed, or expired certificates. Typically, an API will not execute if it encounters a certificate in one of these three statuses. The status of the certificate is beyond the control of an API developer, so if you trust the endpoint, it becomes an inconvenience for the API to fail. Proxies now support the ability to trust all endpoint certificates. You now have the option to choose an endpoint to trust all certificates when you create an endpoint in a Proxy.
SOAP Endpoints
Legacy SOAP services are still prevalent on the web. Enabling SOAP web services in REST APIs provides allows you to take advantage of these services in your REST API endpoints. You can use a Proxy to connect to a SOAP web service and apply API policies against it. In the Create Endpoint dialog, you can easily define parts of the SOAP payload to be dynamically provided by an incoming query parameter or header from the request to execute the Proxy endpoint.
Prerequisites
Org Admin permissions
Viewing the List of Endpoints
To view the list of endpoints for a Proxy:
In SnapLogic Manager, go to API Management > API Manager.
In the API Manager, go to the APIs & Proxies tab.
Set Filter by Type to Proxy and click Search.
Click the Proxy's name in the list.
Go to the Proxy Endpoints tab.
Creating an Endpoint
To create an endpoint:
In the API Manager, open a Proxy for editing, then go to the Proxy Endpoints tab.
Click to open the Create Proxy Endpoint dialog.
Configure the new endpoint:
Field | Description |
---|---|
Endpoint Name | The name for your proxy's endpoint:
|
URL | The URL to which users send their requests. Example: |
HTTP Method(s) | One or more REST methods for the API that this endpoint will service.
|
Trust all Certificates | Select this checkbox to run the API calls regardless of the certificate status. If you leave this checkbox deselected (default setting), any endpoint with an expired or unsigned certificate will fail the API call. |
REST to SOAP | Select this checkbox to enable a SOAP payload as a REST HTTP call. When selected, the SOAP payload filed appears. The derfault setting is unselected. The REST to SOAP checkbox only supports incoming GET requests by default. The HTTP method cannot be modified and will always call the SOAP endpoint with a POST. Example of a valid SOAP payload:
Instead of a static value for Price, you can insert a key, such as UnitPrice, where the value can be defined from the request. The endpoint |
Editing an Endpoint
To edit an endpoint:
In the API Manager, open a proxy for editing, then go to the Proxy Endpoints tab.
Click the endpoint's name in the list.
Learn more: Proxy Endpoint Details.
To edit the proxy details, click the Edit Details button.
Note: You can update only the URL and HTTP Method(s) of the endpoint.
To apply security policies to the endpoint, click the plus icon ( ) below the View Applied Policies button.
Deleting an Endpoint
To delete an endpoint:
In the API Manager, open a proxy for editing, then go to the Proxy Endpoints tab.
Check the box for the endpoint to delete.
Click the trash icon ( ).