C++

Send a REST Request with a Text Body

Demonstrates Rest.FullRequestString, a convenience method that sends a complete request whose text body (such as JSON, XML, or plain text) is supplied directly, then reads and returns the response body as text.

Background. The full-request convenience methods perform the entire request/response exchange in a single call. FullRequestString is well suited to typical JSON or XML API calls where the body fits comfortably in a string.

Chilkat C++ Downloads

Download Chilkat for C++

C++

#include <CkRest.h>

void ChilkatSample(void)
    {
    bool success = false;

    CkRest rest;
    bool bTls = true;
    bool bAutoReconnect = true;
    success = rest.Connect("example.com",443,bTls,bAutoReconnect);
    if (success == false) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    //  Send a complete request whose text body is supplied directly, such as JSON.  The response body is
    //  read as text and returned.  The 1st argument is the HTTP verb, the 2nd is the URI path, and the
    //  3rd is the request body.
    rest.AddHeader("Content-Type","application/json");

    const char *jsonBody = "{ \"name\": \"example\", \"active\": true }";
    const char *responseText = rest.fullRequestString("POST","/api/items",jsonBody);
    if (rest.get_LastMethodSuccess() == false) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    std::cout << responseText << "\r\n";
    }