HTTP API documentation

Version: beta

Functions for performing HTTP and HTTPS requests.

FUNCTION
http.request()	perform a HTTP/HTTPS request

Functions

http.request()

http.request(url,method,callback,[headers],[post_data],[options])

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: number `status`: the status of the response string `response`: the response data table `headers`: all the returned headers
`[headers]`	table optional table with custom headers
`[post_data]`	string optional data to send
`[options]`	table optional table with request parameters. Supported entries: number `timeout`: timeout in seconds

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