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

#include <C_CkStringBuilderW.h>
#include <C_CkHttpW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkStringBuilderW sbCompanyName;
    HCkStringBuilderW sbUrl;
    HCkHttpW http;
    HCkStringBuilderW sbResponse;

    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.
    sbCompanyName = CkStringBuilderW_Create();
    success = CkStringBuilderW_LoadFile(sbCompanyName,L"qa_data/txt/companyName.txt",L"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.
    sbUrl = CkStringBuilderW_Create();
    CkStringBuilderW_Append(sbUrl,L"https://chilkatsoft.com/example?company_name=");
    CkStringBuilderW_Append(sbUrl,CkStringBuilderW_getEncoded(sbCompanyName,L"url",L"utf-8"));

    http = CkHttpW_Create();

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

    sbResponse = CkStringBuilderW_Create();
    success = CkHttpW_QuickGetSb(http,CkStringBuilderW_getAsString(sbUrl),sbResponse);
    if (success == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkStringBuilderW_Dispose(sbCompanyName);
        CkStringBuilderW_Dispose(sbUrl);
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        return;
    }

    wprintf(L"response status code: %d\n",CkHttpW_getLastStatus(http));
    wprintf(L"%s\n",CkStringBuilderW_getAsString(sbResponse));


    CkStringBuilderW_Dispose(sbCompanyName);
    CkStringBuilderW_Dispose(sbUrl);
    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(sbResponse);

    }