Tcl

HTTP GET with Non-USASCII Query Params

See more HTTP Examples

This example illustrates how query parameters in a URL are typically encoded and transmitted. Tcl

load ./chilkat.dll

set success 0

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

# First, let's load the string "Grünhöfer GmbH" from a file.  (This is a fictitious company name.)
# The file uses the utf-8 charset encoding.
set sbCompanyName [new_CkStringBuilder]

set success [CkStringBuilder_LoadFile $sbCompanyName "qa_data/txt/companyName.txt" "utf-8"]
# Assuming success for this example...

# We'll send an HTTP GET request to https://chilkatsoft.com/example?company_name={company name}

# When sending an HTTP GET request with query parameters that contain accented characters 
# (e.g., umlauts: ä, ö, ü), they must be percent-encoded (URL encoded) to ensure proper transmission and 
# interpretation by the server.  This is based on their UTF-8 byte values.
set sbUrl [new_CkStringBuilder]

CkStringBuilder_Append $sbUrl "https://chilkatsoft.com/example?company_name="
CkStringBuilder_Append $sbUrl [CkStringBuilder_getEncoded $sbCompanyName "url" "utf-8"]

set http [new_CkHttp]

# Send the following HTTP GET request:

# GET /example?company_name=Gr%C3%BCnh%C3%B6fer%20GmbH HTTP/1.1
# Host: chilkatsoft.com
# Accept: */*
# Accept-Encoding: gzip

set sbResponse [new_CkStringBuilder]

set success [CkHttp_QuickGetSb $http [CkStringBuilder_getAsString $sbUrl] $sbResponse]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkStringBuilder $sbCompanyName
    delete_CkStringBuilder $sbUrl
    delete_CkHttp $http
    delete_CkStringBuilder $sbResponse
    exit
}

puts "response status code: [CkHttp_get_LastStatus $http]"
puts [CkStringBuilder_getAsString $sbResponse]

delete_CkStringBuilder $sbCompanyName
delete_CkStringBuilder $sbUrl
delete_CkHttp $http
delete_CkStringBuilder $sbResponse