API Overview

This page maps the explicit public API surface exposed by httpx.zig.

Root Module (httpx)

The root module re-exports core types and namespaces. HTTP requests require an initialized client.

Client Operations (URL-first)

• client.fetch(url, options) — primary unified fetch operation (methods, typed JSON, headers, body)
• client.get / post / put / patch / delete / head / options / trace / connect / request(url, options)
• client.getAll(urls) — fetch multiple URLs concurrently
• client.requestAll(requests) — perform multiple custom requests concurrently
• client.checkConnectivity(options) — connectivity probe using client I/O
• Additional operations: client.download, client.graphql, client.lookupFileInfo, client.updateFile, httpx.client.download.verifyFile, client.fetchSitemap, client.resolve, client.resolveUrl

Client Lifecycle

• httpx.Client.init(allocator, io, config) — initialize client with allocator, io, and configuration (or .{} for defaults)
• client.close() — purge the connection pool; client.reset() — close + clear DNS cache

Server Lifecycle

• httpx.Server.init(allocator, io, config) — initialize server with allocator, io, and configuration (or .{} for defaults)
• server.run() — blocking loop; server.start() — background thread
• server.requestShutdown() / server.stop() / server.pause() / server.resumeAccepting()
• server.localPort() — actual bound port

Inline Configuration

• Client settings: passed as the final .{} argument to httpx.Client.init (protocols, timeouts, redirects, retries, pool, proxy, TLS, DNS cache)
• Server settings: passed as the final .{} argument to httpx.Server.init (host, port, strategy, body limits, protocols, docs, TLS, watcher, templates, logging)
• Per-request settings: passed as the final .{} argument to request methods (headers, query, body/json/form/text, auth, timeouts, proxy, TLS)
• httpx.HttpVersion �?" protocol version (.auto, .http10, .http11, .http2, .http3)
• portStrategy accepts .incremental, .strict, or .exit

Server Types

• httpx.Server, httpx.Router, httpx.router.Context, httpx.router.Response
• httpx.tls.Listener, httpx.tls.ListenerConfig, httpx.tls.Request, httpx.tls.Response

Concurrency Helpers

• client.getAll(urls) / client.requestAll(reqs)
• httpx.concurrency.Pool / httpx.concurrency.Queue (src/concurrency/)

Network Helpers

• client.resolve(host, options) / client.resolveUrl(url, options)
• httpx.net.resolve.Resolver, httpx.net.dns, httpx.net.socks5, httpx.net.proxy
• httpx.tcp, httpx.udp, httpx.Address, httpx.net.connectivity

Utility Aliases

• httpx.mime.fromPath(path) — extension-based MIME lookup
• httpx.clock.millisNow(io) / monotonicMillis(io) / sleepMillis(io, ms) — wall-clock, monotonic, and sleep helpers
• httpx.Uri.parse(...) — RFC 3986 URI parsing
• httpx.quic.varint — QUIC variable-length integers

DNS Cache

• Client DNS cache via .dnsCache in the Client.init options (enable, ttlMs, negativeTtlMs, maxEntries)

WebSocket

• httpx.websocket.Handshake.computeAccept / buildUpgradeRequest / validateUpgradeResponse
• httpx.websocket.Frame.parseFrameHeader / buildFrameHeader / applyMask / generateKey

API Groups

• Client API
• Concurrency API
• Core API
• DNS API
• Middleware API
• Network API
• Pool API
• Protocol API
• Router API
• Server API
• TLS API
• Utilities API

Explicit Support Notes

• HTTP/1.0 and HTTP/1.1 are production runtime paths in the high-level client/server API.
• HTTP/2 has high-level client and server runtime paths plus full protocol primitives (HPACK/framing/streams).
• HTTP/3 has a live client runtime path over QUIC + TLS 1.3 (client.get with .httpVersion = .http3, reliable networks) plus full protocol primitives (QPACK/HTTP3/QUIC framing).
• Cross-platform validation is maintained for Linux/Windows (x86, x86_64, aarch64) and macOS (x86_64, aarch64) build matrices.

Customization and Callbacks

• Server event callbacks via .logging = .{ .callback = onEvent } in the options passed to httpx.Server.init
• Client event callbacks via .eventCallback in the Client.init options
• Response JSON helpers: Response.json(T), Response.jsonAlloc(T, allocator)
• Socket primitives: httpx.tcp.Socket / httpx.tcp.Listener, httpx.udp
• Custom middleware: fn (ctx: *Context, next: NextFn) anyerror!Response