External api request
Make external API requests effortlessly with our intuitive interface, enabling dynamic value configuration without code.
Last updated
Make external API requests effortlessly with our intuitive interface, enabling dynamic value configuration without code.
Last updated
API URL
This section contains the request method (e.g., GET, POST, PUT, DELETE) and the API endpoint URL. You can find this information in the documentation provided by your API provider.
f your URL includes dynamic values (e.g., https://api.restful-api.dev/objects/7
, where 7
is dynamic), you can enter the URL like this: https://api.restful-api.dev/objects/___$id___
.
The ___$id___
format allows you to replace 7
with a dynamic value. The ___
(three underscores) acts as a marker, and the $
symbol before id
indicates the dynamic part. After entering the URL in this format, you’ll see a parameter field for id
, where you can configure the dynamic value to be used.
To set up dynamic values, click the plus (+) icon next to the input field. This will allow you to select the data source model from which the value will be pulled.
This section allows you to configure the headers required for your external API request. In most cases, you will need to pass an API key or authentication key, which you can find in the documentation from your API provider.
To add a header, simply provide the header name and its value. The value can be static or dynamically generated. You can also load the value from environment secrets, which is where sensitive information like secret keys or other variables are securely stored using data source model.
For dynamic values, click the plus (+) icon next to the input field. This will load the data source model, allowing you to pull the necessary data dynamically.
This section allows you to pass parameters as query strings in the URL. Query parameters are commonly used for things like pagination or simple search endpoints.
For example, in the endpoint https://api.restful-api.dev/objects
, you may want to list all objects. However, if the API supports pagination via query parameters, you could modify the URL like this: https://api.restful-api.dev/objects?page=1&count=20
.
To achieve this, you can add query parameters by specifying their names (e.g., page
and count
). The values for these parameters can be passed dynamically from your request payload (i.e., the data you're sending when triggering your logic created in Fireapis).
For dynamic values, click the plus (+) icon next to the input field. This will load the data source model, allowing you to pull the necessary data dynamically.
This section allows you to pass the body (data) for your external API requests. It will only be visible when the request method is set to POST or PUT.
For example, for a POST request to https://api.restful-api.dev/objects
, you might need to send the following body data:
In Fireapis, you can create the body by specifying key names (e.g., name
) and setting their values. These values can be configured dynamically to pull from the input payload you pass while executing the logic created in Fireapis.
For dynamic values, click the plus (+) icon next to the input field. This will load the data source model, allowing you to pull the necessary data dynamically.
This section allows you to dynamically add values to the URL. It is useful when calling a GET
API that requires an item ID or a reference value in the URL.
This option will appear when you configure the API URL with dynamic values.
For example, for the endpoint https://api.restful-api.dev/objects/7
, where 7
is a dynamic value, you can enter the URL like this: https://api.restful-api.dev/objects/___$id___
.
Once you enter this, the configuration will display a parameter named id
(which is not editable). You can then set the value for id
by selecting where the data should come from.
For dynamic values, click the plus (+) icon next to the input field. This will load the data source model, allowing you to pull the necessary data dynamically.
Example - 1 Making a GET api request dynamically using dnamic url
Example - 2 Making a POST api request dynamically by passind payload or body data dynamically