`http get` for network

Fetch the contents from a URL.

Signature

> http get {flags} (URL)

Flags

--user, -u {any}: The username when authenticating.
--password, -p {any}: The password when authenticating.
--max-time, -m {duration}: Max duration before timeout occurs.
--headers, -H {any}: Custom headers you want to add.
--raw, -r: Fetch contents as text rather than a table.
--insecure, -k: Allow insecure server connections when using SSL.
--full, -f: Returns the full response instead of only the body.
--allow-errors, -e: Do not fail if the server returns an error code.
--pool: Using a global pool as a client.
--redirect-mode, -R {string}: What to do when encountering redirects. Default: 'follow'. Valid options: 'follow' ('f'), 'manual' ('m'), 'error' ('e').
--unix-socket, -U {path}: Connect to the specified Unix socket instead of using TCP.

Parameters

URL: The URL to fetch the contents from.

Input/output types:

input	output
nothing	any

Examples

Get content from example.com.

> http get https://www.example.com

Get content from example.com, with username and password.

> http get --user myuser --password mypass https://www.example.com

Get content from example.com, with custom header using a record.

> http get --headers {my-header-key: my-header-value} https://www.example.com

Get content from example.com, with custom headers using a list.

> http get --headers [my-header-key-A my-header-value-A my-header-key-B my-header-value-B] https://www.example.com

Get the response status code.

> http get https://www.example.com | metadata | get http_response.status

Check response status while streaming.

> http get --allow-errors https://example.com/file | metadata access {|m| if $m.http_response.status != 200 { error make {msg: "failed"} } else { } } | lines

Get from Docker daemon via Unix socket.

> http get --unix-socket /var/run/docker.sock http://localhost/containers/json

Notes

Performs HTTP GET operation.