Zig

Connect to a REST Server

Demonstrates Rest.Connect, which establishes the initial TCP (and optionally TLS) connection to a REST server. The example connects over HTTPS and then reuses the connection for a request.

Background. A single connection can serve many requests to the same host. The TLS argument should be _TRUE_ for HTTPS (typically port 443), and automatic reconnection lets Chilkat transparently re-establish a dropped keep-alive connection.

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();

    // Connect to the REST server.  The 3rd argument enables TLS (use true for HTTPS on port 443),
    // and the 4th enables automatic reconnection if the connection is dropped between requests.
    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;
    };

    // The connection is now established and ready for requests.  A single connection can be reused for
    // many requests to the same server.
    const response_text = rest.fullRequestNoBody(alloc, "GET", "/api/status") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

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