feat: added docstring for /version endpoint
This commit is contained in:
@@ -6,15 +6,24 @@ import (
|
|||||||
"github.com/robindittmar/dttmr-api/internal/api/response"
|
"github.com/robindittmar/dttmr-api/internal/api/response"
|
||||||
)
|
)
|
||||||
|
|
||||||
type Version struct {
|
type VersionResponse struct {
|
||||||
Version string `json:"version"`
|
Version string `json:"version"`
|
||||||
Commit string `json:"commit"`
|
Commit string `json:"commit"`
|
||||||
BuildTime string `json:"buildTime"`
|
BuildTime string `json:"buildTime"`
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// VersionHandler handles the version route
|
||||||
|
//
|
||||||
|
// @Summary Service version
|
||||||
|
// @Description Reports the version of the API
|
||||||
|
// @Tags Version
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Success 200 {object} VersionResponse
|
||||||
|
// @Router /version [get]
|
||||||
func VersionHandler(version string, commit string, buildTime string) func(http.ResponseWriter, *http.Request) {
|
func VersionHandler(version string, commit string, buildTime string) func(http.ResponseWriter, *http.Request) {
|
||||||
return func(w http.ResponseWriter, r *http.Request) {
|
return func(w http.ResponseWriter, r *http.Request) {
|
||||||
response.JSON(r.Context(), w, http.StatusOK, Version{
|
response.JSON(r.Context(), w, http.StatusOK, VersionResponse{
|
||||||
Version: version,
|
Version: version,
|
||||||
Commit: commit,
|
Commit: commit,
|
||||||
BuildTime: buildTime,
|
BuildTime: buildTime,
|
||||||
|
|||||||
Reference in New Issue
Block a user