(PureBasic) 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 PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttpCurl.pb"

Procedure ChilkatExample()

    success.i = 0

    ; 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.i = CkStringBuilder::ckCreate()
    If sbTargetCurl.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppendLn(sbTargetCurl," curl -X POST https://httpbin.org/post \")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"      -H " + Chr(34) + "Content-Type: application/json" + Chr(34) + " \")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"      -d '{")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"            " + Chr(34) + "title" + Chr(34) + ": " + Chr(34) + "foo" + Chr(34) + ",")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"            " + Chr(34) + "body" + Chr(34) + ": " + Chr(34) + "bar" + Chr(34) + ",")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"            " + Chr(34) + "userId" + Chr(34) + ": 1")
    CkStringBuilder::ckAppendLn(sbTargetCurl,"          }'")

    httpCurl.i = CkHttpCurl::ckCreate()
    If httpCurl.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; 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.i = CkStringBuilder::ckCreate()
    If sbRawRequest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkHttpCurl::ckToRawRequest(httpCurl,CkStringBuilder::ckGetAsString(sbTargetCurl),sbRawRequest)
    If success = 0
        Debug CkHttpCurl::ckLastErrorText(httpCurl)
        CkStringBuilder::ckDispose(sbTargetCurl)
        CkHttpCurl::ckDispose(httpCurl)
        CkStringBuilder::ckDispose(sbRawRequest)
        ProcedureReturn
    EndIf

    ; Display the generated raw HTTP request.
    Debug CkStringBuilder::ckGetAsString(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::ckDispose(sbTargetCurl)
    CkHttpCurl::ckDispose(httpCurl)
    CkStringBuilder::ckDispose(sbRawRequest)


    ProcedureReturn
EndProcedure