module-go-requests

Requests ThingsDB Module (Go)

Request module written using the Go language. This module can be used to make HTTP(S) requests with ThingsDB.

Installation

Install the module by running the following command in the @thingsdb scope:

new_module('requests', 'github.com/thingsdb/module-go-requests');

Optionally, you can choose a specific version by adding a @ followed with the release tag. For example: @v0.1.3.

Configuration

This module does not require any config.

Exposed functions

get

Syntax: get(url, options)

Arguments

• url: The URL to make the GET request to.
• options: Thing with properties to add to the GET request.

Example:

requests.get("https://reqbin.com/echo").then(|res| {
    res;  // just return the response.
});

post

Syntax: post(url, body, options)

Arguments

• url: The URL to make the POST request to.
• body: Body to send with the request (as bytes).
• options: Thing with properties to add to the POST request.

For an example, see post_json below.

post_json

Syntax: post_json(url, body, options)

Like post, except that the headers will be set to accept and send JSON data.

Arguments

• url: The URL to make the POST request to.
• body: Body to send with the request (as bytes).
• options: Thing with properties to add to the POST request.

Example:

record = {
    Id: 78912,
    Customer: "Jason Sweet",
    Quantity: 1,
    Price: 18.00
};
requests.post_json("https://reqbin.com/echo/post/json", json_dump(record)).then(|res| {
    res = res.load();
    json_load(str(res.body));
});

req

Syntax: req(url, options)

A valid method is required.

Arguments

• url: The URL for the request.
• options: Thing with properties for the request. At least a method is required.

Properties