server

Documentation

Index

• func BaseAPIHandler(c *gin.Context)
• func BaseUIHandler(c *gin.Context)
• func CategoryHandler(c *gin.Context)
• func ClueHandler(c *gin.Context)
• func GameHandler(c *gin.Context)
• type ClueFilter
• type Filter
• type Server
  • func NewServer() *Server
• type StringResponse

Functions

func BaseAPIHandler

func BaseAPIHandler(c *gin.Context)

BaseAPIHandler handles the base API route.

func BaseUIHandler

func BaseUIHandler(c *gin.Context)

BaseUIHandler handles the base UI route.

func CategoryHandler

func CategoryHandler(c *gin.Context)

CategoryHandler godoc.

@Summary		Fetch categories
@Description	get categories with optional filters

@Tags			api
@Accept			json
@Produce		json

@Param			random	query		bool	false	"If exists or true, returns `limit` random records."
@Param			id		query		int64	false	"If exists, returns the record with the given id."
@Param			limit	query		int64	false	"Limit the number of records returned."	Default(10)

@Success		200		{array}		models.Category
@Failure		500		{object}	utils.HTTPError
@Router			/category [get]

func ClueHandler

func ClueHandler(c *gin.Context)

ClueHandler godoc

@Summary		Fetch Clues
@Description	get clues with optional filters

@Tags			api
@Accept			json
@Produce		json

@Param			random		query		bool	false	"If exists or true, returns `limit` random records."
@Param			id			query		int64	false	"If exists, returns the record with the given id."
@Param			game		query		integer	false	"Filter by Game ID"
@Param			category	query		integer	false	"Filter by Category ID"
@Param			limit		query		int64	false	"Limit the number of records returned"	Default(10)

@Success		200			{array}		models.Clue
@Failure		500			{object}	utils.HTTPError
@Router			/clue [get]

func GameHandler

func GameHandler(c *gin.Context)

GameHandler godoc

@Summary		Fetch Games
@Description	get games with optional filters

@Tags			api
@Accept			json
@Produce		json

@Param			random	query		bool	false	"If exists or true, returns `limit` random records."
@Param			id		query		int64	false	"If exists, returns the record with the given id."
@Param			limit	query		int64	false	"Limit the number of records returned."	Default(10)

@Success		200		{array}		models.Game
@Failure		500		{object}	utils.HTTPError
@Router			/game [get]

Types

type ClueFilter

type ClueFilter struct {
	Filter
	GameID     int64 `form:"game"`
	CategoryID int64 `form:"category"`
}

type Filter

type Filter struct {
	Random *bool  `form:"random"`
	ID     *int64 `form:"id"`
	Page   *int64 `form:"page,default=0" binding:"min=0"`
	Limit  *int64 `form:"limit,default=1" binding:"min=1,max=100"`
}

type Server

type Server struct {
	ID     string
	Clock  clock.Clock
	Router *gin.Engine
}

Server is the API server.

func NewServer

func NewServer() *Server

NewServer returns a new API server.

type StringResponse

type StringResponse struct {
	Message string `json:"message" example:"some string value"`
}