HTTP

Functions for performing HTTP and HTTPS requests.

http.request()

perform a HTTP/HTTPS request

Perform a HTTP/HTTPS request.

If no timeout value is passed, the configuration value "network.http_timeout" is used. If that is not set, the timeout value is 0 (which blocks indefinitely).

PARAMETERS

url -

string target url

method -

string HTTP/HTTPS method, e.g. "GET", "PUT", "POST" etc.

callback -

function(self, id, response) response callback function

self
object The current object
id
hash Internal message identifier. Do not use!
response
table The response data. Contains the fields:

[headers] -

table optional table with custom headers

[post_data] -

string optional data to send

[options] -

table optional table with request parameters. Supported entries:

EXAMPLES

Basic HTTP-GET request. The callback receives a table with the response in the fields status, the response (the data) and headers (a table).

local function http_result(self, _, response)
    print(response.status)
    print(response.response)
    pprint(response.headers)
end

function init(self)
    http.request("http://www.google.com", "GET", http_result)
end