Lua Requires Chilkat v11.0.0+

URL Encoding Charset in POST Query Params

See more HTTP Examples

Demonstrates how to control the URL encoding charset in POST query params. Lua

local chilkat = require("chilkat")

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

-- We have the string "MÆRSK".
local nameWin1252Encoded = "M%E6RSK"

local sb = chilkat.StringBuilder.new()
local success = sb:decode_and_append(nameWin1252Encoded, "url", "windows-1252")

local http = chilkat.Http.new()

-- We're setting the session log filename so we can see the exact request sent.
http.session_log_filename = "qa_output/sessionLog.txt"

-- First demonstrate a simple application/x-www-form-urlencoded POST

local req = chilkat.HttpRequest.new()

-- Set the Charset = "utf-8" to cause URL encoding to use utf-8.
req.charset = "utf-8"

req:add_param("name", sb:get_as_string())

req.http_verb = "POST"
req.content_type = "application/x-www-form-urlencoded"

local resp = chilkat.HttpResponse.new()
success = http:http_req("https://www.chilkatsoft.com/something", req, resp)
if not success then
    print(http.last_error_text)
    return
end

-- This is the request that is sent:
-- Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

--     POST /something HTTP/1.1
--     Host: www.chilkatsoft.com
--     Content-Type: application/x-www-form-urlencoded
--     Content-Length: 15
--
--     name=M%C3%A6RSK

-- ---------------------------------------------------------------
-- Switch to windows-1252

req.charset = "windows-1252"
req.http_verb = "POST"
req.content_type = "application/x-www-form-urlencoded"

success = http:http_req("https://www.chilkatsoft.com/something", req, resp)
if not success then
    print(http.last_error_text)
    return
end

-- This is the request that is sent:
-- Notice that windows-1252 is used in the query param (the letter 'Æ' is %E6)

--     POST /something HTTP/1.1
--     Host: www.chilkatsoft.com
--     Content-Type: application/x-www-form-urlencoded
--     Content-Length: 12
--
--     name=M%E6RSK

-- ---------------------------------------------------------------
-- Let's do the same with HttpSReq, switching back to utf-8

req.path = "/something"
req.http_verb = "POST"
req.content_type = "application/x-www-form-urlencoded"

req.charset = "utf-8"
success = http:http_sreq("www.chilkatsoft.com", 443, true, req, resp)
if not success then
    print(http.last_error_text)
    return
end

-- This is the request that is sent:
-- Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

--     POST /something HTTP/1.1
--     Host: www.chilkatsoft.com
--     Content-Type: application/x-www-form-urlencoded
--     Content-Length: 15
--
--     name=M%C3%A6RSK

-- ---------------------------------------------------------------
-- Let's do a POST with XML body where the query params are in the HTTP request start line,
-- and the Content-Type is text/xml where the body of the request is XML.

req.path = "/something"
req.http_verb = "POST"
req.content_type = "text/xml"
success = req:load_body_from_string("<test>123</test>", "utf-8")
req.charset = "utf-8"

-- Remember... our request object still contains the query param added in the above call to AddParam.
success = http:http_sreq("www.chilkatsoft.com", 443, true, req, resp)
if not success then
    print(http.last_error_text)
    return
end

-- This is the request that is sent:
-- Notice that utf-8 is used in the query param (the letter 'Æ' is %C3%A6)

--     POST /something?name=M%C3%A6RSK HTTP/1.1
--     Host: www.chilkatsoft.com
--     Content-Type: text/xml
--     Content-Length: 16
--
--     <test>123</test>