Add a Path Substitution Parameter to a REST Request

See more REST Examples

Demonstrates Rest.AddPathParam, which adds or replaces a path-substitution parameter. Before a request is sent, each occurrence of the name in the URI path is replaced with its value.

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;
    };

    // Add path-substitution parameters.  Before a request is sent, each occurrence of the name in the
    // URI path is replaced with the value.  This keeps the path template readable.
    rest.addPathParam("{userId}", "12345") catch {};
    rest.addPathParam("{orderId}", "98765") catch {};

    // The placeholders in the path are replaced before the request is sent.
    const response_text = rest.fullRequestNoBody(alloc, "GET", "/users/{userId}/orders/{orderId}") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

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