Make a HTTP request¶

Dixer provides a way to make a HTTP request with this request types: POST, GET, DELETE, PUT, HEAD, OPTIONS, PATCH, CONNECT, and TRACE.

To use it, create a job with type httprequest.

Keys:

• connection_id: mandatory. Connection ID. String.
• request_type: mandatory. Specify request type type. String.
• request_type_var: optional. Variable for request type. String.
• request_body: optional. Specify body if necessary. String.
• request_body_var: optional. Variable for body if necessary. String.
• save_output: optional. Specify if result returned need to be saved. Bool. Default false
• save_output_var: optional. Variable save_output. String.
• output_path: optional. Specify output path of request result content. String.
• output_path_var: optional. Variable output path. String.
• expected_status_code: optional. Specify the expected http status code. Trigger error 8135 when not expected is returned. Int.
• expected_status_code_var: optional. Variable expected_status_code. String.
• headers: optional. Object to set headers. Will replace header keys in connection if configured. Object.
• headers_var: optional. Key to set a variable with the headers, the variable shoule be a map type with a json in his value, example value: {"authorization":"Basic dXNlcjpwYXNzd2Q="} . String.

If save_output is true then a output path need to be specified.

Examples:

[[jobs]]
id = 'get_request_job'
name = 'Request GET'
type = 'httprequest'
request_type = 'get'
ignore_error = false
disable = false
connection_id = 'http-connection'
request_body = 'hola'
output_path = 'requestget.txt'
save_output = true
expected_status_code = 200
[jobs.headers]
    authorization = 'Basic dXNlcjpwYXNzd2Q='

[[jobs]]
id = 'post_request_job'
name = 'Request POST'
type = 'httprequest'
request_type = 'post'
ignore_error = false
disable = false
connection_id = 'http-connection'
request_body = """
{\r
    \"name\": \"morpheus\",\r
    \"job\": \"leader\"\r
}"""
output_path = 'requestpost.txt'
save_output = true