HTTP-request step

These cube allow send many http requests to another hosts.

HTTP-request step allows you to interact with HTTP & REST APIs
1. Set request method, paste URL and add parameters
You can add parameters both in URL input, like https://api.directual.com?param1=aaaa&param2={{field}} or using Parameters tab. Feel free to add {{fields}} using template system.
Remember that if parameter value contains characters like " ", "+", "–", wrap it in {{#encodeURIComponent}} parameter value {{/encodeURIComponent}}
2. Optional: Add headers and Body
You can add headers and body  for your request, using template system.
Note that choosing the body type (json, x-www-form-urlencoded) you add specific headers.
If your JSON-body includes strings with special characters (like "), wrap it with {{#escape}}wrapped "text"{{/escape}}
3. Optional: Setup auth
Choose the proper auth (or no one) and the authorisation header will be automatically generated when you send the request.
4. Optional: Add custom options
Save API response to the field. Field should be type of json or string. It's easy to parse the response using JSON-step.
Ignore HTTP-errors. If this option is turned off, scenario will stop executing and call Catch error step, if any. If it is on, the scenario will continue executing.
Enable retry. Retry the request in case of error-code.
Retry non idempotent requests (e.g. POST). have a look at a nice explanation what is non idempotent requests.
Retry count. How many times retry connecting.
Read timeout, ms. Max 180000 — 180 sec.
Connect timeout, ms. Max 5000 — 5 sec.
Certificates. Add (if needed) .PEM text and key
Proxy. Add (if needed) proxy. You may have one here (choose IPv4).
5. Sending files
Set the content type to multipart/form-data
Body for that type of request should be the following:
{
	"file": "{{ContextVar.fileUrl}}", // URL of your file
	"__files_fields__":["file"]
}
​

Integration steps

Zapier step

Last modified 3mo ago