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.