Http.Head¶
Name | Mandatory | Description | Default | Type |
---|---|---|---|---|
⬅️ Input |
The input for this shard should either be none or an optional string table of query parameters to append to the URL. | None {String} |
||
Output ➡️ |
The output is the headers of the response from the server through the HEAD request. | {status: Int headers: {String} body: Bytes} Bytes {status: Int headers: {String} body: String} String Http.Stream {status: Int headers: {String} stream: Http.Stream} |
||
URL |
No | The url to request to. | `` | String Var(String) |
Headers |
No | If a table of headers is provided, it will be used as is; if no headers are provided, a Content-Type header will be derived based on the input type. | none |
None {String} Var({String}) |
Timeout |
No | How many seconds to wait for the request to complete, including the connection and any read operations. | 10 |
Int |
Bytes |
No | If instead of a string the shard should output bytes. | false |
Bool |
FullResponse |
No | If the output should be a table with the full response, including headers and status. This also implies that Retry and Backoff will be ignored. | false |
Bool |
AcceptInvalidCerts |
No | If we should ignore invalid certificates. This is useful for testing but should not be used in production. | false |
Bool |
Retry |
No | How many times to retry the request if it fails. | 0 |
Int |
Streaming |
No | If the response should be streamed, in which case the output will be an object to use with the Http.Stream shard. If full response is also requested, the body will be empty and a field 'stream' will be added to the table with the response object. | false |
Bool |
Backoff |
No | Initial backoff time in seconds (will increase exponentially with each retry). Defaults to 1 second. | 1 |
Int |
This shard sends a HEAD request to the specified URL and outputs the response.
Details¶
This shard can accept a string table as input to append query parameters to the specified URL. For example,
{
"param1": "value1"
"param2": "value2"
"param3": "value3"
} = queryParams
queryParams
Http.Get("https://api.example.com/endpoint")
https://api.example.com/endpoint?param1=value1¶m2=value2¶m3=value3
This shard is similar to the Http.Get shard, but it only returns the headers of the response and not the body.