Our great sponsors
-
InfluxDB
Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.
-
goa
š Goa: Elevate Go API development! š Streamlined design, automatic code generation, and seamless HTTP/gRPC support. āØ
-
kin-openapi
OpenAPI 3.0 (and Swagger v2) implementation for Go (parsing, converting, validation, and more)
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
I have been using https://github.com/swaggo/swag with https://github.com/swaggo/gin-swagger.
No I use this one https://github.com/swaggo/gin-swagger. It's with swagger 2.0, but I think it can be easily converted to OpenApi 3.0. I tried it once and the only thing it complained about was some simple "metadata" like contact person etc.
I am using goa.design as is described there https://goa.design/design/overview/ (I am do not use gRPC - only REST).
Iām personally using this project for open api code generation https://github.com/deepmap/oapi-codegen
We have better experience with https://goa.design/ than with https://github.com/twitchtv/twirp
After the source code is generated, the gen/http directory contains yaml and json files in two versions (openapi, openapi3). Here is an example: https://github.com/goadesign/examples/tree/master/basic/gen/http
I recently used https://github.com/getkin/kin-openapi openapi2 and openapi2conv to convert the v2 yaml to v3 yaml.
https://editor.swagger.io and select Edit > Convert to OpenAPI 3 from the menu