diff --git a/controllers/gdd_controller.go b/controllers/gdd_controller.go index 2c74ba3f5456a4d9e74ea55256052a48e9d16e45..fbf32674181caa4e97ed6f9394380aa320c98955 100644 --- a/controllers/gdd_controller.go +++ b/controllers/gdd_controller.go @@ -12,19 +12,25 @@ import ( var GetGddValues = services.GetGddValues // GetDailyGdd godoc +<<<<<<< controllers/gdd_controller.go +// @Summary Get GDD Values for given year +// @Tags Gdd, public +// @Security ApiKeyAuth +======= // @Summary Get gdd values // @Tags Gdd, public // @Description get gdd values +>>>>>>> controllers/gdd_controller.go // @Accept json // @Produce json // @Success 200 {object} models.GddResponse // @Failure 400 {object} errors.StandardError // @Param year query int true "Year to get gdd for" -// @Param product query string true "Crop to calculate gdd for" Enums(corn, soybean, sunflower, tomato, sugar_beet, peanut, cotton, potato, wheat, pea, oat, spring_wheat, rice, sorghum) +// @Param product query string true "Crop to calculate gdd for" Enums(corn) // @Param latitude query number true "Latitude to search for" // @Param longitude query number true "Longitude to search for" // @Param accumulate query boolean true "Accumulate gdd values" -// @Param plantingDate query string true "Plant date, ISO8601 or RFC3339 format" +// @Param plantingDate query string true "Plant date RFC3339 format" // @Router /gdd/daily [get] func GetDailyGdd(c *fiber.Ctx) error { ctx := common.DawnCtx{FiberCtx: c} @@ -33,14 +39,14 @@ func GetDailyGdd(c *fiber.Ctx) error { } // GetNormalGdd godoc -// @Summary Get gdd normals -// @Tags Gdd -// @Description get gdd normals +// @Summary Get GDD normals over the past 30 years +// @Tags Gdd, public +// @Security ApiKeyAuth // @Accept json // @Produce json // @Success 200 {object} models.GddResponse // @Failure 400 {object} errors.StandardError -// @Param product query string true "Crop to calculate gdd for" Enums(corn, soybean, sunflower, tomato, sugar_beet, peanut, cotton, potato, wheat, pea, oat, spring_wheat, rice, sorghum) +// @Param product query string true "Crop to calculate gdd for" Enums(corn) // @Param latitude query number true "Latitude to search for" // @Param longitude query number true "Longitude to search for" // @Param accumulate query boolean true "Accumulate gdd values" diff --git a/main.go b/main.go index d91aba74f92a2e3dddaf87f9ef458bd9b2a157bc..b0791fc0ab618ba9ef137837de254be6f717d6ba 100644 --- a/main.go +++ b/main.go @@ -4,6 +4,12 @@ import ( "gitlab.cs.umd.edu/dawn/go-backend/dawn-gdd/cmd" ) +// @title Dawn GDD Service +// @contact.name API Support +// @contact.email tgsiegel@umd.edu +// @securityDefinitions.apikey ApiKeyAuth +// @in header +// @name Authorization func main() { cmd.Execute() }