Add a Query Parameter to a REST Request

See more REST Examples

Demonstrates Rest.AddQueryParam, which adds or replaces a query-string parameter. The 1st argument is the parameter name and the 2nd is its value; Chilkat URL-encodes both as needed.

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 query-string parameters.  The 1st argument is the parameter name and the 2nd is its value.
    // Chilkat automatically URL-encodes names and values as needed.
    rest.addQueryParam("q", "chilkat rest") catch {};
    rest.addQueryParam("limit", "10") catch {};

    // For a GET request the parameters are appended to the URL query string.
    const response_text = rest.fullRequestNoBody(alloc, "GET", "/api/search") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

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