Zig

Send a Staged Multipart REST Request

Demonstrates Rest.SendReqMultipart, which sends a multipart request using the parts configured on the object, then reads the response in separate steps.

Background. The staged request model separates sending from reading: a SendReq method transmits the request, ReadResponseHeader reads the status line and headers, and a ReadResp method reads the body. This gives fine control over large or streamed messages compared with the single-call full-request methods.

Chilkat Zig Downloads

Download Chilkat for Zig

Zig

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

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

    const rest = try chilkat.Rest.init();
    defer rest.deinit();
    const b_tls = true;
    const b_auto_reconnect = true;
    rest.connect("example.com", 443, b_tls, b_auto_reconnect) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // Configure one multipart part before sending.
    rest.setPartSelector("1");
    rest.addHeader("Content-Type", "text/plain") catch {};
    rest.addHeader("Content-Disposition", "form-data; name=\"field1\"") catch {};
    rest.setMultipartBodyString("value1") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // Send the multipart request using the configured parts.
    rest.sendReqMultipart("POST", "/api/upload") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // After sending, read the response status line and header fields.  The return value is the HTTP
    // status code, or -1 if no response was received.
    const status_code = rest.readResponseHeader();
    if (status_code < 0) {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    }

    std.debug.print("Response status code: {d}\n", .{status_code});

    // Read the response body as text.
    const response_body = rest.readRespBodyString(alloc) catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("{s}\n", .{response_body});
}