OPENAPI3_SWAGGER.md

OpenAPI 3 / Swagger

• OpenAPI 3 Specification (3.0.0)

Tools

• github.com/getkin/kin-openapi/openapi3: Package openapi3 parses and writes OpenAPI 3 specifications.
• Swagger Editor
• Swagger Codegen 3.X
• Swagger UI, local copy is in cmd/rest-server/static/swagger-ui.
  • Local demo: http//0.0.0.0:9234/static/swagger-ui/

Swagger Codegen 3.X

For Go the types in pkg/openapi3/: oapi-codegen is used for generating them.

For other languages you may want to use: swaggerapi/swagger-codegen-cli-v3, for example for Ruby:

docker run --rm -v ${PWD}:/gen swaggerapi/swagger-codegen-cli-v3:3.0.25 generate \
  --verbose \
  --input-spec http://host.docker.internal:9234/openapi3.yaml \
  --lang ruby \
  --output /gen