Skip to main content

HTTP request (detailed)

Referenced In

Fields

FieldTypeDescriptionDefault
urlstringOptional. URL for the HTTP request.

Pattern: `(^(http://
https://).*
openApione of:
- unknown
- unknown
Optional. No description provided.
statusCodesarray of integerOptional. Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.[200,201]
methodstringOptional. Method of the HTTP request

Accepted values: get, put, post, patch, delete
get
timeoutintegerOptional. Timeout for the HTTP request, in milliseconds.60000
requestobject(Request)Optional. No description provided.
responseobject(Response)Optional. No description provided.
allowAdditionalFieldsbooleanOptional. If false, the step fails when the response data contains fields not specified in the response body.true
pathstringOptional. File path to save the command's output, relative to directory. Specify a file extension that matches the expected response type, such as .json for JSON content or .txt for strings.
directorystringOptional. Directory to save the command's output. If the directory doesn't exist, creates the directory. If not specified, the directory is your media directory.
maxVariationnumberOptional. Allowed variation in percentage of text different between the current output and previously saved output. If the difference between the current output and the previous output is greater than maxVariation, the step fails. If output doesn't exist at path, this value is ignored.

Minimum: 0. Maximum: 1
0
overwritestringOptional. If true, overwrites the existing output at path if it exists.
If aboveVariation, overwrites the existing output at path if the difference between the new output and the existing output is greater than maxVariation.

Accepted values: true, false, aboveVariation
aboveVariation

Examples

{
"url": "example",
"statusCodes": [
200,
201
],
"method": "get",
"timeout": 60000,
"request": {},
"response": {
"headers": {},
"body": {}
},
"allowAdditionalFields": true,
"path": "example",
"directory": "example",
"maxVariation": 0,
"overwrite": "aboveVariation"
}