Compare commits

...

2 commits

Author SHA1 Message Date
Imbus
2be4afd0e0 Correct ish swagger docstring 2024-03-18 20:05:47 +01:00
Imbus
2aade5d2fe Docs example 2024-03-18 19:59:14 +01:00
2 changed files with 30 additions and 5 deletions

View file

@ -32,6 +32,17 @@ const docTemplate = `{
"User" "User"
], ],
"summary": "Register a new user", "summary": "Register a new user",
"parameters": [
{
"description": "User to register",
"name": "{string}",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/types.NewUser"
}
}
],
"responses": { "responses": {
"200": { "200": {
"description": "User added", "description": "User added",
@ -55,6 +66,19 @@ const docTemplate = `{
} }
} }
}, },
"definitions": {
"types.NewUser": {
"type": "object",
"properties": {
"password": {
"type": "string"
},
"username": {
"type": "string"
}
}
}
},
"externalDocs": { "externalDocs": {
"description": "OpenAPI", "description": "OpenAPI",
"url": "https://swagger.io/resources/open-api/" "url": "https://swagger.io/resources/open-api/"

View file

@ -15,11 +15,12 @@ import (
// @Description Register a new user // @Description Register a new user
// @Tags User // @Tags User
// @Accept json // @Accept json
// @Produce json // @Produce plain
// @Param NewUser body types.NewUser true "User to register"
// @Success 200 {string} string "User added" // @Success 200 {string} string "User added"
// @Failure 400 {string} string "Bad request" // @Failure 400 {string} string "Bad request"
// @Failure 500 {string} string "Internal server error" // @Failure 500 {string} string "Internal server error"
// @Router /api/register [post] // @Router /register [post]
func (gs *GState) Register(c *fiber.Ctx) error { func (gs *GState) Register(c *fiber.Ctx) error {
u := new(types.NewUser) u := new(types.NewUser)
if err := c.BodyParser(u); err != nil { if err := c.BodyParser(u); err != nil {