Basic Requests

The httpx.zig client supports all standard HTTP methods and provides convenient wrappers for common operations.

Creating a Client

For simple usage, create a client with the default configuration:

var client = httpx.Client.init(allocator);
defer client.deinit();

For more control, use ClientConfig:

const config = httpx.ClientConfig{
    .base_url = "https://api.github.com",
    .user_agent = "MyApp/1.0",
    .timeouts = .{
        .connect_ms = 5000,
        .read_ms = 10000,
    },
    .http2_enabled = false,
};
var client = httpx.Client.initWithConfig(allocator, config);
defer client.deinit();

Making Requests

GET

const response = try client.get("https://httpbin.org/get", .{});
defer response.deinit();

if (response.status.isSuccess()) {
    std.debug.print("Body: {s}\n", .{response.body.?});
}

POST JSON

You can easily send JSON using the .json option, which automatically sets the Content-Type header to application/json.

const body = "{\"name\": \"Alice\", \"role\": \"admin\"}";
const response = try client.post("https://httpbin.org/post", .{
    .json = body,
});
defer response.deinit();

Other Methods

// PUT
_ = try client.put("/users/1", .{ .json = updated_json });

// DELETE
_ = try client.delete("/users/1", .{});

// HEAD
const head_res = try client.head("/large-file", .{});

Request Options

The second argument to request methods is RequestOptions:

pub const RequestOptions = struct {
    headers: ?[]const [2][]const u8 = null, // Custom headers
    body: ?[]const u8 = null,              // Raw body
    json: ?[]const u8 = null,              // JSON body
    timeout_ms: ?u64 = null,               // Request-specific timeout
    follow_redirects: ?bool = null,        // Override redirect policy
};

Response Handling

The Response object provides helpers to access data:

// Check status
if (response.ok()) { ... }

// Get headers
if (response.headers.get("Content-Type")) |ct| { ... }

// Parse JSON response
const MyStruct = struct { id: u32, name: []const u8 };
const data = try response.json(MyStruct);