Usage

Pick a section below. The core pages explain the interfaces and layering that the rest of the library is built on — start there if you want a mental model before diving into any specific area.

  • Features and compliance to internet standards.
  • The interfaces, content-type plumbing and validation hooks the client and server pieces are built on. Start here for a mental model.
  • HTTP client transport — TLS, auth, OpenTelemetry tracing and request submission for go-swagger-generated and untyped API clients.
  • Server-side request lifecycle — routing, parameter binding, validation, security and operation execution.
  • The dependency-free server-middleware module — media types, content negotiation and doc-UI handlers, usable from any net/http server.
  • Runnable snippets covering common runtime usage scenarios — server assembly, client setup, custom middleware and authentication.