C++

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. C++

#include <CkStringBuilder.h>
#include <CkHttp.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  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.
    CkStringBuilder sbCompanyName;
    success = sbCompanyName.LoadFile("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.
    CkStringBuilder sbUrl;
    sbUrl.Append("https://chilkatsoft.com/example?company_name=");
    sbUrl.Append(sbCompanyName.getEncoded("url","utf-8"));

    CkHttp http;

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

    CkStringBuilder sbResponse;
    success = http.QuickGetSb(sbUrl.getAsString(),sbResponse);
    if (success == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "response status code: " << http.get_LastStatus() << "\r\n";
    std::cout << sbResponse.getAsString() << "\r\n";
    }