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 Jun 22 08:18:17 UTC 2021 against commit 2235c7b2235c7b18f86f1cf214e246b88b0ea193d87fe80.

Current version is 2.2.1100 BETA which has been verified against tests.