Sample code for 30+ languages & platforms
Unicode C

Add a Query Parameter to a REST Request

See more REST Examples

Demonstrates Rest.AddQueryParam, which adds or replaces a query-string parameter. The 1st argument is the parameter name and the 2nd is its value; Chilkat URL-encodes both as needed.

Background. For a GET request the accumulated parameters are appended to the URL query string. For a form-url-encoded request the same parameters form the request body.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkRestW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkRestW rest;
    BOOL bTls;
    BOOL bAutoReconnect;
    const wchar_t *responseText;

    success = FALSE;

    rest = CkRestW_Create();

    //  Connect to the REST server.  The 3rd argument enables TLS (use TRUE for HTTPS on port 443),
    //  and the 4th enables automatic reconnection if the connection is dropped between requests.
    bTls = TRUE;
    bAutoReconnect = TRUE;
    success = CkRestW_Connect(rest,L"example.com",443,bTls,bAutoReconnect);
    if (success == FALSE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    //  Add query-string parameters.  The 1st argument is the parameter name and the 2nd is its value.
    //  Chilkat automatically URL-encodes names and values as needed.
    CkRestW_AddQueryParam(rest,L"q",L"chilkat rest");
    CkRestW_AddQueryParam(rest,L"limit",L"10");

    //  For a GET request the parameters are appended to the URL query string.
    responseText = CkRestW_fullRequestNoBody(rest,L"GET",L"/api/search");
    if (CkRestW_getLastMethodSuccess(rest) == FALSE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        return;
    }

    wprintf(L"%s\n",responseText);


    CkRestW_Dispose(rest);

    }