package main

import (
	"net/http"
)

type MyStruct struct {
	ID int `json:"id" example:"1" format:"int64"`
	// Post name
	Name string `json:"name" example:"poti"`
	// Post data
	Data struct {
		// Post tag
		Tag []string `json:"name"`
	} `json:"data"`
	// not-exported variable, for internal use only, not marshaled
	internal1 string
	internal2 int
	internal3 bool
	internal4 struct {
		NestedInternal string
	}
}

// @Summary Call DoSomething
// @Description Does something, but internal (non-exported) fields inside a struct won't be marshaled into JSON
// @Accept  json
// @Produce  json
// @Success 200 {object} MyStruct
// @Router /so-something [get]
func DoSomething(w http.ResponseWriter, r *http.Request) {
	//write your code
}

// @title Swagger Example API
// @version 1.0
// @description This is a sample server.
// @host localhost:4000
// @basePath /api
func main() {
	http.HandleFunc("/do-something", DoSomething)
	http.ListenAndServe(":8080", nil)
}