(C) Viewing the Raw HTTP Request Generated from a curl Command

See more CURL Examples

This example demonstrates how to convert a curl command into the exact raw HTTP request that would be sent to the server—without actually sending it.

By calling ToRawRequest, the curl command is translated into its underlying HTTP representation, including the request line, headers, and body. This is especially useful for debugging, verifying request formatting, and understanding how a curl command maps to a real HTTP request.

In this example, a POST request with a JSON body is constructed using curl syntax. The code then converts it to the raw HTTP request format and prints the result. This allows you to inspect details such as the Content-Length, header formatting, and the exact payload being transmitted.

This technique is helpful when troubleshooting issues related to request composition, encoding, or server-side behavior.

Note: This example requires Chilkat v11.5.0 or greater.

Chilkat C/C++ Library Downloads
MS Visual C/C++ C++ Builder Linux C/C++ Alpine Linux C/C++	MacOS C/C++ iOS C/C++ Android C/C++ MinGW C/C++

#include <C_CkStringBuilder.h>
#include <C_CkHttpCurl.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkStringBuilder sbTargetCurl;
    HCkHttpCurl httpCurl;
    HCkStringBuilder sbRawRequest;

    success = FALSE;

    // Build a curl command and convert it to the raw HTTP request that would be sent.
    // This allows you to inspect the exact request (headers + body) without actually sending it.

    //  curl -X POST https://httpbin.org/post \
    //       -H "Content-Type: application/json" \
    //       -d '{
    //             "title": "foo",
    //             "body": "bar",
    //             "userId": 1
    //           }'

    // The backslashes at the end of lines are not required.  Chilkat ignores them if present.
    sbTargetCurl = CkStringBuilder_Create();
    CkStringBuilder_AppendLn(sbTargetCurl," curl -X POST https://httpbin.org/post \\");
    CkStringBuilder_AppendLn(sbTargetCurl,"      -H \"Content-Type: application/json\" \\");
    CkStringBuilder_AppendLn(sbTargetCurl,"      -d '{");
    CkStringBuilder_AppendLn(sbTargetCurl,"            \"title\": \"foo\",");
    CkStringBuilder_AppendLn(sbTargetCurl,"            \"body\": \"bar\",");
    CkStringBuilder_AppendLn(sbTargetCurl,"            \"userId\": 1");
    CkStringBuilder_AppendLn(sbTargetCurl,"          }'");

    httpCurl = CkHttpCurl_Create();

    // Convert the curl command into a raw HTTP request string.
    // This is useful for debugging, as it shows exactly what would be sent to the server
    // (request line, headers, and body) for the given curl command.
    sbRawRequest = CkStringBuilder_Create();
    success = CkHttpCurl_ToRawRequest(httpCurl,CkStringBuilder_getAsString(sbTargetCurl),sbRawRequest);
    if (success == FALSE) {
        printf("%s\n",CkHttpCurl_lastErrorText(httpCurl));
        CkStringBuilder_Dispose(sbTargetCurl);
        CkHttpCurl_Dispose(httpCurl);
        CkStringBuilder_Dispose(sbRawRequest);
        return;
    }

    // Display the generated raw HTTP request.
    printf("%s\n",CkStringBuilder_getAsString(sbRawRequest));

    // Expected output:

    // POST /post HTTP/1.1
    // Host: httpbin.org
    // Content-Type: application/json
    // Content-Length: 96
    // 
    // {
    //             "title": "foo",
    //             "body": "bar",
    //             "userId": 1
    //           }


    CkStringBuilder_Dispose(sbTargetCurl);
    CkHttpCurl_Dispose(httpCurl);
    CkStringBuilder_Dispose(sbRawRequest);

    }