Post

api.http.Post(url, headers, body)

Sends an HTTP request to an endpoint. It uses the standard HTTP method POST, to indicate that the request wishes to create or update information.

Parameters:

Name	Type	Description
url	string	The address of the endpoint to send the request to.
headers	table	Provides additional information to the endpoint, on how it should respond to the request.
body	string	The message to be sent to the endpoint, with information to create or update its data store.

Returns:

Type	Description
int	The HTTP code relaying the success of the request or otherwise.
string	The body of the HTTP response to the request.

Example:

Send a POST request to an endpoint, updating its data.

-- init.lua
function init()
    if not chunk.Generated then
        local code, body = api.http.POST("https://eg.mydatabase.com/chunks", 
                            {
                                ["Content-Type"]="text/plain",
                                ["Authorisation"]="Basic YWxhZGRpbjp"},
                            "cool!")
        
        if code == 200 then
          print("Response returned successfully: "..body)
          print("Chunks have been updated.")
        else
          print("Response returned HTTP code: "..code)
        end
    end
end

-- Send a POST HTTP request to the url https://eg.mydatabase.com/chunks.
-- The endpoint url updates its data based on the request's body: "cool!"
-- The endpoint responds with some updated data about chunks.
-- The string body of the response is printed.

-- Prints (dependent on endpoint response):
-- Response returned successfully: Chunks were lame. Chunks are cool!
-- Chunks have been updated.

-- Or Prints (exact code number varies):
-- Response returned HTTP code: 404