# httpx.zig

> HTTP client and server library for Zig

Production-grade HTTP/1.x/2/3 client and server runtime with proxy support, concurrency, and protocol primitives

## Table of Contents

### Getting Started

- [Getting Started](/httpx.zig/guide/getting-started.md)
- [Installation](/httpx.zig/guide/installation.md)

### Client Guide

- [Basic Requests](/httpx.zig/guide/client-basics.md)
- [Request Construction & Options](/httpx.zig/guide/requests.md)
- [Response Handling](/httpx.zig/guide/responses.md)
- [Streaming Guide](/httpx.zig/guide/streaming.md)
- [Cookies Guide](/httpx.zig/guide/cookies.md)
- [Authentication Guide](/httpx.zig/guide/authentication.md)
- [Connection Pooling Guide](/httpx.zig/guide/pooling.md)
- [Concurrency & Async Tasks](/httpx.zig/guide/concurrency.md)
- [Proxies & SOCKS5 Guide](/httpx.zig/guide/proxies.md)
- [TLS Configuration Guide](/httpx.zig/guide/tls.md)
- [DNS Resolution Guide](/httpx.zig/guide/dns.md)

### Server Guide

- [Routing](/httpx.zig/guide/routing.md)
- [Middleware](/httpx.zig/guide/middleware.md)
- [Static Files Guide](/httpx.zig/guide/static-files.md)
- [Single-File Deployment (Embedded vs Filesystem Assets)](/httpx.zig/guide/single-file.md)
- [Multipart Form Data Guide](/httpx.zig/guide/multipart.md)
- [Session Management Guide](/httpx.zig/guide/sessions.md)
- [Rate Limiting Guide](/httpx.zig/guide/rate-limiting.md)
- [WebSockets Guide](/httpx.zig/guide/websockets.md)
- [Server-Sent Events (SSE)](/httpx.zig/web/sse.md)
- [Server Deployment, Reverse Proxy & Cloud Architecture](/httpx.zig/guide/deployment.md)

### Advanced & Protocols

- [HTTP/2 Protocol](/httpx.zig/guide/http2.md)
- [HTTP/3 Protocol](/httpx.zig/guide/http3.md)
- [GraphQL Guide](/httpx.zig/guide/graphql.md)
- [OpenAPI Guide](/httpx.zig/guide/openapi.md)
- [Parsing Architecture & Tree-sitter Usage](/httpx.zig/guide/parsing.md)
- [HTTP Caching Guide](/httpx.zig/guide/caching.md)
- [Compression Guide](/httpx.zig/guide/compression.md)
- [Unix Domain Sockets Guide](/httpx.zig/guide/unix-sockets.md)
- [Metrics and Observability Guide](/httpx.zig/guide/metrics.md)
- [Interceptors](/httpx.zig/guide/interceptors.md)
- [Benchmarks & Performance](/httpx.zig/reference/benchmarks.md): Comprehensive performance benchmarks for HTTPX covering core parsing, routing, serialization, compression, concurrency, DNS, protocols, and end-to-end client/server throughput.

### API Reference

- [API Overview](/httpx.zig/api.md)
- [Core API](/httpx.zig/api/core.md)
- [Client API](/httpx.zig/api/client.md)
- [Server API](/httpx.zig/api/server.md)
- [API: Request](/httpx.zig/api/request.md)
- [API: Response](/httpx.zig/api/response.md)
- [API: Headers](/httpx.zig/api/headers.md)
- [Router API](/httpx.zig/api/router.md)
- [Middleware API](/httpx.zig/api/middleware.md)
- [Connection Pool API](/httpx.zig/api/pool.md)
- [Concurrency API](/httpx.zig/api/concurrency.md)
- [TLS API](/httpx.zig/api/tls.md)
- [DNS API Reference](/httpx.zig/api/dns.md)
- [Network API](/httpx.zig/api/net.md)
- [Protocol API](/httpx.zig/api/protocol.md)
- [IO Utilities API](/httpx.zig/api/io.md)
- [Compression API](/httpx.zig/api/compression.md)
- [Cache API](/httpx.zig/api/cache.md)
- [Data Formats API](/httpx.zig/api/data.md)
- [Metrics API](/httpx.zig/api/metrics.md)
- [Session API](/httpx.zig/api/session.md)
- [SSE API](/httpx.zig/api/sse.md)
- [API: WebSocket](/httpx.zig/api/websocket.md)
- [API: FTP](/httpx.zig/api/ftp.md)
- [API: Proxy](/httpx.zig/api/proxy.md)
- [Utilities API](/httpx.zig/api/utils.md)

### Web Framework

- [GraphQL Integration](/httpx.zig/web/graphql.md)
- [OpenAPI Specification](/httpx.zig/web/openapi.md)
- [Interactive Documentation UIs](/httpx.zig/web/documentation-ui.md)
- [HTML & Document Parsing](/httpx.zig/web/html.md)
- [Static File Serving](/httpx.zig/web/static-files.md)
- [Single Page Applications (SPA)](/httpx.zig/web/spa.md)
- [HTML Templates & View Rendering](/httpx.zig/web/templates.md)
- [Server-Sent Events (SSE)](/httpx.zig/web/sse.md)
- [WebSocket Server & Client](/httpx.zig/web/websocket.md)

### HTTP Protocols

- [HTTP/1.0 Protocol](/httpx.zig/protocols/http-1.0.md)
- [HTTP/1.1 Protocol](/httpx.zig/protocols/http-1.1.md)
- [HTTP/2 Protocol](/httpx.zig/protocols/http-2.md)
- [HTTP/3 Protocol](/httpx.zig/protocols/http-3.md)

### Transport & Security

- [TLS 1.2 Protocol](/httpx.zig/protocols/tls-1.2.md)
- [TLS 1.3 Protocol](/httpx.zig/protocols/tls-1.3.md)
- [ALPN (Application-Layer Protocol Negotiation)](/httpx.zig/protocols/alpn.md)
- [QUIC Transport Protocol](/httpx.zig/protocols/quic.md)
- [TCP Sockets](/httpx.zig/protocols/tcp.md)
- [UDP Sockets](/httpx.zig/protocols/udp.md)

### Networking & FTP

- [DNS Resolution Protocol & Architecture](/httpx.zig/protocols/dns.md)
- [HTTP Proxies & Tunnels](/httpx.zig/protocols/proxies.md)
- [SOCKS5 Protocol](/httpx.zig/protocols/socks5.md)
- [SOCKS5H (Remote DNS SOCKS5)](/httpx.zig/protocols/socks5h.md)
- [FTP (File Transfer Protocol)](/httpx.zig/protocols/ftp.md)
- [FTPS (FTP over TLS)](/httpx.zig/protocols/ftp-tls.md)

### Security Architecture

- [Security Architecture](/httpx.zig/security/overview.md)
- [TLS Security & Best Practices](/httpx.zig/security/tls.md)
- [Security Headers](/httpx.zig/security/headers.md)
- [Path Traversal Protection](/httpx.zig/security/path-security.md)
- [Request Limits & DoS Hardening](/httpx.zig/security/request-limits.md)
- [Cookie Security](/httpx.zig/security/cookies.md)
- [CORS (Cross-Origin Resource Sharing)](/httpx.zig/security/cors.md)
- [Rate Limiting & DoS Protection](/httpx.zig/security/rate-limiting.md)

### Observability

- [Structured Lifecycle Events](/httpx.zig/observability/events.md)
- [Logging Guide](/httpx.zig/observability/logging.md)
- [Metrics & Monitoring](/httpx.zig/observability/metrics.md)
- [Distributed Tracing](/httpx.zig/observability/tracing.md)

### Runnable Examples

- [Examples](/httpx.zig/examples.md)
- [Example: Dedicated HTTP/1.1 Client](/httpx.zig/examples/http11-client.md)
- [Example: Dedicated HTTP/1.1 Server](/httpx.zig/examples/http11-server.md)
- [Simple Get](/httpx.zig/examples/simple-get.md)
- [Simple Get Deserialize](/httpx.zig/examples/simple-get-deserialize.md)
- [Post JSON](/httpx.zig/examples/post-json.md)
- [Custom Headers](/httpx.zig/examples/custom-headers.md)
- [HTTP Auth Helpers](/httpx.zig/examples/http-auth-helpers.md)
- [Concurrent Requests](/httpx.zig/examples/concurrent-requests.md)
- [Connection Pool](/httpx.zig/examples/connection-pool.md)
- [Cookies Demo](/httpx.zig/examples/cookies-demo.md)
- [Proxy and Reverse Proxy](/httpx.zig/examples/proxy-example.md)
- [SOCKS5h Proxy Example](/httpx.zig/examples/socks5-proxy.md)
- [Simple Server](/httpx.zig/examples/simple-server.md)
- [Async Server Example](/httpx.zig/examples/async-server-example.md)
- [Router Example](/httpx.zig/examples/router-example.md)
- [Middleware Example](/httpx.zig/examples/middleware-example.md)
- [Streaming](/httpx.zig/examples/streaming.md)
- [Static Files](/httpx.zig/examples/static-files.md)
- [Multi Page Website](/httpx.zig/examples/multi-page-website.md)
- [HTTP/2 Example](/httpx.zig/examples/http2-example.md)
- [HTTP/3 Example](/httpx.zig/examples/http3-example.md)
- [WebSocket Example](/httpx.zig/examples/websocket-example.md)
- [Server-Sent Events (SSE) Example](/httpx.zig/examples/sse-example.md)
- [Multipart Form Data Example](/httpx.zig/examples/multipart-example.md)
- [Metrics and Observability Example](/httpx.zig/examples/metrics-example.md)
- [Logging Callback](/httpx.zig/examples/logging-callback.md)
- [TLS Server Example](/httpx.zig/examples/tls-server.md)
- [HTTPS Client](/httpx.zig/examples/https-client.md)
- [TLS Custom CA Certificate](/httpx.zig/examples/tls-custom-ca.md)
- [FTP Client](/httpx.zig/examples/ftp-client.md)
- [Example: Ftp Server](/httpx.zig/examples/ftp-server.md)
- [Example: Ftp Download](/httpx.zig/examples/ftp-download.md)

### Reference & Benchmarks

- [Benchmarks & Performance](/httpx.zig/reference/benchmarks.md): Comprehensive performance benchmarks for HTTPX covering core parsing, routing, serialization, compression, concurrency, DNS, protocols, and end-to-end client/server throughput.

### Other

- [Batch Concurrent Requests](/httpx.zig/examples/batch-concurrent.md)
- [Cloud HTTPS Server Example](/httpx.zig/examples/cloud-https-server.md)
- [Compression](/httpx.zig/examples/compression-example.md)
- [DNS Cache Example](/httpx.zig/examples/dns-cache.md)
- [DNS Configuration Example](/httpx.zig/examples/dns-configuration.md)
- [DNS Resolution Example](/httpx.zig/examples/dns-example.md)
- [Example: Auth And Errors](/httpx.zig/examples/auth-and-errors.md)
- [Example: Body Parser Server](/httpx.zig/examples/body-parser-server.md)
- [Example: Browser Demo Server](/httpx.zig/examples/browser-demo-server.md)
- [Example: Compression Demo](/httpx.zig/examples/compression-demo.md)
- [Example: Concurrent Demo](/httpx.zig/examples/concurrent-demo.md)
- [Example: Connectivity](/httpx.zig/examples/connectivity.md)
- [Example: Cookie Server](/httpx.zig/examples/cookie-server.md)
- [Example: Cors Server](/httpx.zig/examples/cors-server.md)
- [Example: Custom Responses](/httpx.zig/examples/custom-responses.md)
- [Example: Custom Server](/httpx.zig/examples/custom-server.md)
- [Example: DNS Demo](/httpx.zig/examples/dns-demo.md)
- [Example: Docs Server](/httpx.zig/examples/docs-server.md)
- [Example: Download](/httpx.zig/examples/download.md)
- [Example: Download Batch](/httpx.zig/examples/download-batch.md)
- [Example: Download Checksum File](/httpx.zig/examples/download-checksum-file.md)
- [Example: Download Custom Progress](/httpx.zig/examples/download-custom-progress.md)
- [Example: Download Existing](/httpx.zig/examples/download-existing.md)
- [Example: Download Info](/httpx.zig/examples/download-info.md)
- [Example: Download Resume](/httpx.zig/examples/download-resume.md)
- [Example: Download Update](/httpx.zig/examples/download-update.md)
- [Example: Download Verify](/httpx.zig/examples/download-verify.md)
- [Example: Full Integration](/httpx.zig/examples/full-integration.md)
- [Example: Graphql Server](/httpx.zig/examples/graphql-server.md)
- [Example: Health Check](/httpx.zig/examples/health-check.md)
- [Example: Helmet Server](/httpx.zig/examples/helmet-server.md)
- [Example: Hostname Resolution](/httpx.zig/examples/resolve.md)
- [Example: Http10 Client](/httpx.zig/examples/http10-client.md)
- [Example: Http2 Client](/httpx.zig/examples/http2-client.md)
- [Example: Http2 Multiplex](/httpx.zig/examples/http2-multiplex.md)
- [Example: Http3 Client](/httpx.zig/examples/http3-client.md)
- [Example: Http3 Quic](/httpx.zig/examples/http3-quic.md)
- [Example: Interceptor Example](/httpx.zig/examples/interceptor-example.md)
- [Example: Live Static Watcher](/httpx.zig/examples/live-static-watcher.md)
- [Example: Metrics Server](/httpx.zig/examples/metrics-server.md)
- [Example: Multipart](/httpx.zig/examples/multipart.md)
- [Example: Openapi](/httpx.zig/examples/openapi.md)
- [Example: Parse Html](/httpx.zig/examples/parse-html.md)
- [Example: Proxy Demo](/httpx.zig/examples/proxy-demo.md)
- [Example: Rate Limit Server](/httpx.zig/examples/rate-limit-server.md)
- [Example: Redirect](/httpx.zig/examples/redirect.md)
- [Example: Retry Demo](/httpx.zig/examples/retry-demo.md)
- [Example: Session Server](/httpx.zig/examples/session-server.md)
- [Example: Spa Fallback](/httpx.zig/examples/spa-fallback.md)
- [Example: Sse Server](/httpx.zig/examples/sse-server.md)
- [Example: Tls Get](/httpx.zig/examples/tls-get.md)
- [Example: Tls12 Client](/httpx.zig/examples/tls12-client.md)
- [Example: Tls13 Client](/httpx.zig/examples/tls13-client.md)
- [Health Check Example](/httpx.zig/examples/health-check-example.md)
- [HTTP Cache](/httpx.zig/examples/http-cache-example.md)
- [HTTP Methods](/httpx.zig/examples/http-methods.md)
- [HTTP/2 Advanced Example](/httpx.zig/examples/http2-advanced.md)
- [HTTP/2 Client Runtime Example](/httpx.zig/examples/http2-client-runtime.md)
- [HTTP/2 Server Runtime Example](/httpx.zig/examples/http2-server-runtime.md)
- [HTTP/3 Advanced Example](/httpx.zig/examples/http3-advanced.md)
- [HTTP/3 Client Runtime Example](/httpx.zig/examples/http3-client-runtime.md)
- [HTTP/3 Server Runtime Example](/httpx.zig/examples/http3-server-runtime.md)
- [Interceptors](/httpx.zig/examples/interceptors.md)
- [JSON API Example](/httpx.zig/examples/json-api-example.md)
- [Multi-Address DNS Resolution Example](/httpx.zig/examples/dns-resolve-all.md)
- [Pre-Route Logic and Global Fallback Example](/httpx.zig/examples/pre-route-example.md)
- [Readiness Probe Example](/httpx.zig/examples/readiness-probe-example.md)
- [Redirect Following Example](/httpx.zig/examples/redirect-example.md)
- [Request and Response Customization](/httpx.zig/examples/request-response-customization.md)
- [Retry Example](/httpx.zig/examples/retry-example.md)
- [Reverse Proxy Middleware Example](/httpx.zig/examples/reverse-proxy-middleware.md)
- [Session Example](/httpx.zig/examples/session-example.md)
- [Simplified API Aliases](/httpx.zig/examples/simplified-api-aliases.md)
- [Streaming Compression](/httpx.zig/examples/streaming-compression-example.md)
- [TCP Local](/httpx.zig/examples/tcp-local.md)
- [TLS Configuration Options](/httpx.zig/examples/tls-config-options.md)
- [TLS Handshake Details](/httpx.zig/examples/tls-handshake-details.md)
- [TLS HTTPS GET](/httpx.zig/examples/tls-https-get.md)
- [TLS Mutual Authentication (mTLS)](/httpx.zig/examples/tls-mtls.md)
- [Transfer Checksum](/httpx.zig/examples/transfer-checksum.md)
- [Transfer Download](/httpx.zig/examples/transfer-download.md)
- [Transfer Progress](/httpx.zig/examples/transfer-progress.md)
- [UDP Local](/httpx.zig/examples/udp-local.md)
- [Unix Domain Socket Example](/httpx.zig/examples/unix-socket-example.md)
- [WebSocket Server Example](/httpx.zig/examples/websocket-server.md)