Swift 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. Swift

func chilkatTest() {
    var success: Bool = false

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

    //  We have the string "MÆRSK".
    var nameWin1252Encoded: String? = "M%E6RSK"

    let sb = CkoStringBuilder()!
    success = sb.decodeAndAppend(value: nameWin1252Encoded, encoding: "url", charset: "windows-1252")

    let http = CkoHttp()!

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

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

    let req = CkoHttpRequest()!

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

    req.addParam(name: "name", value: sb.getAsString())

    req.httpVerb = "POST"
    req.contentType = "application/x-www-form-urlencoded"

    let resp = CkoHttpResponse()!
    success = http.httpReq(url: "https://www.chilkatsoft.com/something", request: req, response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        return
    }

    //  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.httpVerb = "POST"
    req.contentType = "application/x-www-form-urlencoded"

    success = http.httpReq(url: "https://www.chilkatsoft.com/something", request: req, response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        return
    }

    //  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.httpVerb = "POST"
    req.contentType = "application/x-www-form-urlencoded"

    req.charset = "utf-8"
    success = http.httpSReq(domain: "www.chilkatsoft.com", port: 443, ssl: true, request: req, response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        return
    }

    //  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.httpVerb = "POST"
    req.contentType = "text/xml"
    success = req.loadBody(fromString: "<test>123</test>", charset: "utf-8")
    req.charset = "utf-8"

    //  Remember... our request object still contains the query param added in the above call to AddParam.
    success = http.httpSReq(domain: "www.chilkatsoft.com", port: 443, ssl: true, request: req, response: resp)
    if success == false {
        print("\(http.lastErrorText!)")
        return
    }

    //  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>

}