Guides

Browse by concern. Every guide maps to a directory in the go-swagger/examples repository, so you can clone it and run the code alongside the page.

  • Generating HTTP servers from a spec — from the canonical todo-list server to strict handlers, custom error handling, file upload/download and CRUD APIs.
  • Generating a typed SDK client (classic and stratoscale flavors) and a command-line client tool from the same spec.
  • Wiring security into a generated server — basic and API-key auth, composed security requirements, and a full OAuth2 access-code handshake.
  • Generating a server that streams newline-delimited JSON bodies, and a client that consumes the stream.
  • Going beyond the defaults — custom templates, external type bindings, generation flags, plugging in net/http middleware, and alias compatibility.