Lua

HTTP HEAD Request

See more HTTP Examples

Sends an HTTP HEAD request and gets the response.

Note: The response to an HTTP HEAD request is always just the response header. The reponse body is always 0 length (thus the reason it's called a "HEAD" request..)

Lua

local chilkat = require("chilkat")

-- This example assumes the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.

local http = chilkat.Http.new()

-- If the URL uses "https://", then the connection will be TLS.
-- Otherwise it will be TCP.

-- A failure is when we don't get any response.  It could be a timeout, an inability to connect, etc.
-- For example, a "404 Not Found" response is still a response, and thus deemed success in terms of the API..

local resp = chilkat.HttpResponse.new()
local success = http:http_no_body("HEAD", "https://example-code.com/", resp)
if not success then
    print(http.last_error_text)
    return
end

-- Examine the response.
print("Status Code = " .. resp.status_code)
print("Status Line = " .. resp.status_line)
print("Status Text = " .. resp.status_text)
print("Full Response Header:")
print(resp.header)
print("----")
local numHeaderFields = resp.num_header_fields
print("Num Header Fields: " .. numHeaderFields)
for i = 0, numHeaderFields - 1 do
    print(resp:get_header_name(i) .. ": " .. resp:get_header_value(i))
end