chore: add multiple api example (#207)

* chore: add multiple api example
* chore: update README.md

example/multiple/api/v1/example.go

@@ -0,0 +1,26 @@
+package v1
+
+import (
+	"github.com/gin-gonic/gin"
+)
+
+type Book struct {
+	ID     int     `json:"id,omitempty"`
+	Title  string  `json:"title"`
+	Author string  `json:"author"`
+	Year   *uint16 `json:"year"`
+}
+
+//
+// @Summary Get a list of books in the the store
+// @Description get string by ID
+// @Accept  json
+// @Produce  json
+// @Success 200 {array} Book "ok"
+// @Router /books [get]
+func GetBooks(ctx *gin.Context) {
+	ctx.JSON(200, []Book{
+		{ID: 1, Title: "Book 1", Author: "Author 1", Year: nil},
+		{ID: 2, Title: "Book 2", Author: "Author 2", Year: nil},
+	})
+}

example/multiple/api/v1/main.go

@@ -0,0 +1,25 @@
+package v1
+
+import (
+	"github.com/gin-gonic/gin"
+)
+
+// @title Swagger Example API
+// @version 1.0
+// @description This is a sample server.
+// @termsOfService http://swagger.io/terms/
+
+// @contact.name API Support
+// @contact.url http://www.swagger.io/support
+// @contact.email support@swagger.io
+
+// @license.name Apache 2.0
+// @license.url http://www.apache.org/licenses/LICENSE-2.0.html
+
+// @BasePath /v1
+
+func Register(router *gin.Engine) {
+	v1 := router.Group("v1")
+
+	v1.GET("/books", GetBooks)
+}

example/multiple/api/v2/example.go

@@ -0,0 +1,26 @@
+package v2
+
+import (
+	"github.com/gin-gonic/gin"
+)
+
+type Book struct {
+	ID     int     `json:"id,omitempty"`
+	Title  string  `json:"title"`
+	Author string  `json:"author"`
+	Year   *uint16 `json:"year"`
+}
+
+//
+// @Summary Get a list of books in the the store
+// @Description get string by ID
+// @Accept  json
+// @Produce  json
+// @Success 200 {array} Book "ok"
+// @Router /books [get]
+func GetBooks(ctx *gin.Context) {
+	ctx.JSON(200, []Book{
+		{ID: 1, Title: "Book 3", Author: "Author 3", Year: nil},
+		{ID: 2, Title: "Book 4", Author: "Author 4", Year: nil},
+	})
+}

example/multiple/api/v2/main.go

@@ -0,0 +1,25 @@
+package v2
+
+import (
+	"github.com/gin-gonic/gin"
+)
+
+// @title Swagger Example API
+// @version 2.0
+// @description This is a sample server.
+// @termsOfService http://swagger.io/terms/
+
+// @contact.name API Support
+// @contact.url http://www.swagger.io/support
+// @contact.email support@swagger.io
+
+// @license.name Apache 2.0
+// @license.url http://www.apache.org/licenses/LICENSE-2.0.html
+
+// @BasePath /v2
+
+func Register(router *gin.Engine) {
+	v2 := router.Group("v2")
+
+	v2.GET("/books", GetBooks)
+}