Zig Requires Chilkat v11.5.0+

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.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // 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.
    const sb_target_curl = try chilkat.StringBuilder.init();
    defer sb_target_curl.deinit();
    sb_target_curl.appendLn(" curl -X POST https://httpbin.org/post \\") catch {};
    sb_target_curl.appendLn("      -H \"Content-Type: application/json\" \\") catch {};
    sb_target_curl.appendLn("      -d '{") catch {};
    sb_target_curl.appendLn("            \"title\": \"foo\",") catch {};
    sb_target_curl.appendLn("            \"body\": \"bar\",") catch {};
    sb_target_curl.appendLn("            \"userId\": 1") catch {};
    sb_target_curl.appendLn("          }'") catch {};

    const http_curl = try chilkat.HttpCurl.init();
    defer http_curl.deinit();

    // 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.
    const sb_raw_request = try chilkat.StringBuilder.init();
    defer sb_raw_request.deinit();
    http_curl.toRawRequest(try sb_target_curl.getAsString(alloc), sb_raw_request) catch {
        std.debug.print("{s}\n", .{try http_curl.getLastErrorText(alloc)});
        return;
    };

    // Display the generated raw HTTP request.
    std.debug.print("{s}\n", .{try sb_raw_request.getAsString(alloc)});

    // Expected output:

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