Unicode C
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
#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);
}