murex Shell Docs

Command Reference: get

Makes a standard HTTP request and returns the result as a JSON object

Description

Fetches a page from a URL via HTTP/S GET request

Usage

get url -> <stdout>

<stdin> -> get url -> <stdout>

Examples

» get google.com -> [ Status ]
{
    "Code": 200,
    "Message": "OK"
}

Detail

JSON return

get returns a JSON object with the following fields:

{
    "Status": {
        "Code": integer,
        "Message": string,
    },
    "Headers": {
        string [
            string...
        ]
    },
    "Body": string
}

The concept behind this is it provides and easier path for scripting eg pulling
specific fields via the index, `[`, function.

### `get` as a method

Running `get` as a method will transmit the contents of STDIN as part of the
body of the HTTP GET request. When run as a method you have to include a second
parameter specifying the Content-Type MIME.

### Configurable options

`get` has a number of behavioral options which can be configured via _murex_'s
standard `config` tool:

config: -> [ http ]

To change a default, for example the user agent string:

config: set http user-agent "bob"

get: google.com

This enables sane, repeatable and readable defaults. Read the documents on
`config` for more details about it's usage and the rational behind the command.

See Also

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Tue Sep 20 07:48:14 UTC 2022 against commit 1769d5b1769d5bb0ba4eaf204a5e0f52053b8f877bb7466.

Current version is 2.11.2030 which has been verified against 16798 tests cases.