URL
Last updated
Last updated
The endpoint URL page is used to define the HTTP method and URL to be used, and any required URL parameters:
To add an endpoint URL, you must select the appropriate HTTP method:
...and then add the required URL:
You can define two types of parameter:
In the example below, our endpoint URL is set to GET all products, but we are adding a default URL parameter to add a query which will only retrieve products with a product_type
of snowboard
:
Optional parameters are available for your users to update with their own required values, in process flows.
If we consider the example above - we are always restricting our 'GET all products' endpoint to return only products with a product_type
of snowboard
. But suppose we wanted to allow users to choose a product_type
at the point they are running a process flow?
When a process flow runs for this connector, associated API requests are injected with the user-provided URL parameter value wherever a {{product_type}}
parameter is found.
However, there may be scenarios where you need to ensure that a URL parameter is always provided by users running a process flow. For this, a slightly different approach is needed - in this case, you would:
parameters are added as key pairs and are always applied for the endpoint, whenever it is used. Use the top panel to add required parameters.
parameters are displayed as filters, so users can apply with their own values when using this endpoint as a data source in . Use the lower panel to add optional parameters.
Any parameters that you add (to either panel) here are automatically appended to the existing as a query parameter when this endpoint is used in .
If you have parameters that must always be passed in the endpoint request URL, add them to the top panel. Default parameters are added as key pairs, and are passed straight into requests - users are never asked to provide values for these in .
By adding this as a default URL parameter for the endpoint, this query will be applied whenever this endpoint is added to (via a ). The actual endpoint used will be:
You can define static values for a default URL parameter, or use a variable. For an example of where variables might be useful here, see
When a includes a which is configured to use this endpoint, users can see/update filter fields for any optional URL parameters that have been defined for the endpoint. For example, let's add an optional parameter for product_type
:
Now if we configure a with this endpoint, a product_type filter option is available, so the person running this flow can choose to use it if they wish:
are just that - users can choose to add a parameter value if they wish. If a user doesn't choose to update an optional URL parameter field, then no query is applied.
Step 1 Add a 'required' for the field that you want to force users to update in process flows.
Step 2 Update the to include a query for this variable.
Step 3 Add a , specifying your endpoint variable (added in step 1) as the parameter value.
Step 4 Now when a user adds this endpoint to a in a , they must update this variable field before proceeding.
Techniques for adding URL parameters are same as all other types of parameters that you may encounter in the connector builder. For information about these options please see the page.
If this option is OFF, users won't see it unless they select the add new filter button and add it manually - for example: