(Unicode C++) PostUrlEncoded Clarified

This example is intended to help clarify the behavior of the PostUrlEncoded method.

The intent of PostUrlEncoded is to send a POST request with the HTTP request parameters located in the HTTP request body using the x-www-form-urlencoded format. In many cases, the developer already has the desired request params in a typical GET URL format, where the params are specified in the URL (after the "?" character). For example:

https://www.chilkatsoft.com/blah/moreblah?key=ABC123&value=XYZ

POST /blah/moreblah HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: www.chilkatsoft.com
Content-Length: 20

key=ABC123&value=XYZ

POST /blah/moreblah?key=ABC123 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: www.chilkatsoft.com
Content-Length: 10

value=XYZ

This can be done by calling SynchronousRequest. The SynchronousRequest method allows for the parts of the request to be explicitly built via the HTTP request object. (see the example code below).

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <CkHttpW.h>
#include <CkHttpRequestW.h>
#include <CkHttpResponseW.h>

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

    CkHttpW http;

    // To see the exact HTTP request sent and the response, set the SessionLogFilename property:
    http.put_SessionLogFilename(L"/httpLogs/chilkatHttpLog.txt");

    // Send the POST where all request parameters are located in the HTTP request body
    // in the x-www-form-urlencoded format.  (We are passing a default/empty HTTP request object.
    // The HTTP request object is where additional headers, or additional request parameters
    // be added.)
    CkHttpRequestW req;
    CkHttpResponseW *resp = http.PostUrlEncoded(L"https://www.chilkatsoft.com/blah/moreblah?key=ABC123&value=XYZ",req);
    if (http.get_LastMethodSuccess() == false) {
        wprintf(L"%s\n",http.lastErrorText());
        return;
    }

    // Do whatever is desired with the response object...

    delete resp;

    // Show how to call SynchronousRequest to send a POST where "key=ABC123" is in the path 
    // of the request, and the "value=XYZ" is in the request body.
    CkHttpRequestW req2;
    req2.put_Path(L"/blah/moreblah?key=ABC123");
    req2.AddParam(L"value",L"XYZ");
    req2.put_HttpVerb(L"POST");

    bool bUseTls = true;
    const wchar_t *domain = L"www.chilkatsoft.com";
    int port = 443;
    resp = http.SynchronousRequest(domain,port,bUseTls,req2);
    if (http.get_LastMethodSuccess() == false) {
        wprintf(L"%s\n",http.lastErrorText());
        return;
    }

    // Do whatever is desired with the response object...

    delete resp;
    }