update swagger docs
This commit is contained in:
Fran Jurmanović
@@ -5,12 +5,12 @@
|
|||||||
// @description API for managing Assetto Corsa Competizione dedicated servers
|
// @description API for managing Assetto Corsa Competizione dedicated servers
|
||||||
//
|
//
|
||||||
// @contact.name ACC Server Manager Support
|
// @contact.name ACC Server Manager Support
|
||||||
// @contact.url https://github.com/yourusername/acc-server-manager
|
// @contact.url https://github.com/FJurmanovic/acc-server-manager
|
||||||
//
|
//
|
||||||
// @license.name MIT
|
// @license.name MIT
|
||||||
// @license.url https://opensource.org/licenses/MIT
|
// @license.url https://opensource.org/licenses/MIT
|
||||||
//
|
//
|
||||||
// @host localhost:3000
|
// @host https://acc.jurmanovic.com
|
||||||
// @BasePath /api/v1
|
// @BasePath /api/v1
|
||||||
// @schemes http https
|
// @schemes http https
|
||||||
//
|
//
|
||||||
|
|||||||
@@ -61,7 +61,7 @@ func NewMembershipController(service *service.MembershipService, auth *middlewar
|
|||||||
// @Failure 400 {object} error_handler.ErrorResponse "Invalid request body"
|
// @Failure 400 {object} error_handler.ErrorResponse "Invalid request body"
|
||||||
// @Failure 401 {object} error_handler.ErrorResponse "Invalid credentials"
|
// @Failure 401 {object} error_handler.ErrorResponse "Invalid credentials"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Router /auth/login [post]
|
// @Router /v1/auth/login [post]
|
||||||
func (c *MembershipController) Login(ctx *fiber.Ctx) error {
|
func (c *MembershipController) Login(ctx *fiber.Ctx) error {
|
||||||
type request struct {
|
type request struct {
|
||||||
Username string `json:"username"`
|
Username string `json:"username"`
|
||||||
@@ -96,7 +96,7 @@ func (c *MembershipController) Login(ctx *fiber.Ctx) error {
|
|||||||
// @Failure 409 {object} error_handler.ErrorResponse "User already exists"
|
// @Failure 409 {object} error_handler.ErrorResponse "User already exists"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /membership [post]
|
// @Router /v1/membership [post]
|
||||||
func (mc *MembershipController) CreateUser(c *fiber.Ctx) error {
|
func (mc *MembershipController) CreateUser(c *fiber.Ctx) error {
|
||||||
type request struct {
|
type request struct {
|
||||||
Username string `json:"username"`
|
Username string `json:"username"`
|
||||||
@@ -128,7 +128,7 @@ func (mc *MembershipController) CreateUser(c *fiber.Ctx) error {
|
|||||||
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /membership [get]
|
// @Router /v1/membership [get]
|
||||||
func (mc *MembershipController) ListUsers(c *fiber.Ctx) error {
|
func (mc *MembershipController) ListUsers(c *fiber.Ctx) error {
|
||||||
users, err := mc.service.ListUsers(c.UserContext())
|
users, err := mc.service.ListUsers(c.UserContext())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -139,6 +139,18 @@ func (mc *MembershipController) ListUsers(c *fiber.Ctx) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// GetUser gets a single user by ID.
|
// GetUser gets a single user by ID.
|
||||||
|
// @Summary Get user by ID
|
||||||
|
// @Description Get detailed information about a specific user
|
||||||
|
// @Tags User Management
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Param id path string true "User ID (UUID format)"
|
||||||
|
// @Success 200 {object} model.User "User details"
|
||||||
|
// @Failure 400 {object} error_handler.ErrorResponse "Invalid user ID format"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 404 {object} error_handler.ErrorResponse "User not found"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/membership/{id} [get]
|
||||||
func (mc *MembershipController) GetUser(c *fiber.Ctx) error {
|
func (mc *MembershipController) GetUser(c *fiber.Ctx) error {
|
||||||
id, err := uuid.Parse(c.Params("id"))
|
id, err := uuid.Parse(c.Params("id"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -154,6 +166,16 @@ func (mc *MembershipController) GetUser(c *fiber.Ctx) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// GetMe returns the currently authenticated user's details.
|
// GetMe returns the currently authenticated user's details.
|
||||||
|
// @Summary Get current user details
|
||||||
|
// @Description Get details of the currently authenticated user
|
||||||
|
// @Tags Authentication
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Success 200 {object} model.User "Current user details"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 404 {object} error_handler.ErrorResponse "User not found"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/auth/me [get]
|
||||||
func (mc *MembershipController) GetMe(c *fiber.Ctx) error {
|
func (mc *MembershipController) GetMe(c *fiber.Ctx) error {
|
||||||
userID, ok := c.Locals("userID").(string)
|
userID, ok := c.Locals("userID").(string)
|
||||||
if !ok || userID == "" {
|
if !ok || userID == "" {
|
||||||
@@ -172,6 +194,19 @@ func (mc *MembershipController) GetMe(c *fiber.Ctx) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// DeleteUser deletes a user.
|
// DeleteUser deletes a user.
|
||||||
|
// @Summary Delete user
|
||||||
|
// @Description Delete a specific user by ID
|
||||||
|
// @Tags User Management
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Param id path string true "User ID (UUID format)"
|
||||||
|
// @Success 204 "User successfully deleted"
|
||||||
|
// @Failure 400 {object} error_handler.ErrorResponse "Invalid user ID format"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
||||||
|
// @Failure 404 {object} error_handler.ErrorResponse "User not found"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/membership/{id} [delete]
|
||||||
func (mc *MembershipController) DeleteUser(c *fiber.Ctx) error {
|
func (mc *MembershipController) DeleteUser(c *fiber.Ctx) error {
|
||||||
id, err := uuid.Parse(c.Params("id"))
|
id, err := uuid.Parse(c.Params("id"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -187,6 +222,20 @@ func (mc *MembershipController) DeleteUser(c *fiber.Ctx) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// UpdateUser updates a user.
|
// UpdateUser updates a user.
|
||||||
|
// @Summary Update user
|
||||||
|
// @Description Update user details by ID
|
||||||
|
// @Tags User Management
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Param id path string true "User ID (UUID format)"
|
||||||
|
// @Param user body service.UpdateUserRequest true "Updated user details"
|
||||||
|
// @Success 200 {object} model.User "Updated user details"
|
||||||
|
// @Failure 400 {object} error_handler.ErrorResponse "Invalid request body or ID format"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
||||||
|
// @Failure 404 {object} error_handler.ErrorResponse "User not found"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/membership/{id} [put]
|
||||||
func (mc *MembershipController) UpdateUser(c *fiber.Ctx) error {
|
func (mc *MembershipController) UpdateUser(c *fiber.Ctx) error {
|
||||||
id, err := uuid.Parse(c.Params("id"))
|
id, err := uuid.Parse(c.Params("id"))
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -207,6 +256,17 @@ func (mc *MembershipController) UpdateUser(c *fiber.Ctx) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// GetRoles returns all available roles.
|
// GetRoles returns all available roles.
|
||||||
|
// @Summary Get all roles
|
||||||
|
// @Description Get a list of all available user roles
|
||||||
|
// @Tags User Management
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Success 200 {array} model.Role "List of roles"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
||||||
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/membership/roles [get]
|
||||||
func (mc *MembershipController) GetRoles(c *fiber.Ctx) error {
|
func (mc *MembershipController) GetRoles(c *fiber.Ctx) error {
|
||||||
roles, err := mc.service.GetAllRoles(c.UserContext())
|
roles, err := mc.service.GetAllRoles(c.UserContext())
|
||||||
if err != nil {
|
if err != nil {
|
||||||
|
|||||||
@@ -50,7 +50,7 @@ func NewServerController(ss *service.ServerService, routeGroups *common.RouteGro
|
|||||||
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /server [get]
|
// @Router /v1/api/server [get]
|
||||||
func (ac *ServerController) GetAllApi(c *fiber.Ctx) error {
|
func (ac *ServerController) GetAllApi(c *fiber.Ctx) error {
|
||||||
var filter model.ServerFilter
|
var filter model.ServerFilter
|
||||||
if err := common.ParseQueryFilter(c, &filter); err != nil {
|
if err := common.ParseQueryFilter(c, &filter); err != nil {
|
||||||
@@ -181,7 +181,21 @@ func (ac *ServerController) UpdateServer(c *fiber.Ctx) error {
|
|||||||
return c.JSON(server)
|
return c.JSON(server)
|
||||||
}
|
}
|
||||||
|
|
||||||
// DeleteServer deletes a server
|
// DeleteServer deletes an existing server
|
||||||
|
// @Summary Delete an ACC server
|
||||||
|
// @Description Delete an existing ACC server
|
||||||
|
// @Tags Server
|
||||||
|
// @Accept json
|
||||||
|
// @Produce json
|
||||||
|
// @Param id path string true "Server ID (UUID format)"
|
||||||
|
// @Success 200 {object} object "Deleted server details"
|
||||||
|
// @Failure 400 {object} error_handler.ErrorResponse "Invalid server data or ID"
|
||||||
|
// @Failure 401 {object} error_handler.ErrorResponse "Unauthorized"
|
||||||
|
// @Failure 403 {object} error_handler.ErrorResponse "Insufficient permissions"
|
||||||
|
// @Failure 404 {object} error_handler.ErrorResponse "Server not found"
|
||||||
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
|
// @Security BearerAuth
|
||||||
|
// @Router /v1/server/{id} [delete]
|
||||||
func (ac *ServerController) DeleteServer(c *fiber.Ctx) error {
|
func (ac *ServerController) DeleteServer(c *fiber.Ctx) error {
|
||||||
serverIDStr := c.Params("id")
|
serverIDStr := c.Params("id")
|
||||||
serverID, err := uuid.Parse(serverIDStr)
|
serverID, err := uuid.Parse(serverIDStr)
|
||||||
|
|||||||
@@ -51,7 +51,7 @@ func NewServiceControlController(as *service.ServiceControlService, routeGroups
|
|||||||
// @Failure 404 {object} error_handler.ErrorResponse "Service not found"
|
// @Failure 404 {object} error_handler.ErrorResponse "Service not found"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /v1/service-control/{service} [get]
|
// @Router /v1/server/{id}/service/{service} [get]
|
||||||
func (ac *ServiceControlController) getStatus(c *fiber.Ctx) error {
|
func (ac *ServiceControlController) getStatus(c *fiber.Ctx) error {
|
||||||
id := c.Params("id")
|
id := c.Params("id")
|
||||||
c.Locals("serverId", id)
|
c.Locals("serverId", id)
|
||||||
@@ -78,7 +78,7 @@ func (ac *ServiceControlController) getStatus(c *fiber.Ctx) error {
|
|||||||
// @Failure 409 {object} error_handler.ErrorResponse "Service already running"
|
// @Failure 409 {object} error_handler.ErrorResponse "Service already running"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /v1/service-control/start [post]
|
// @Router /v1/server/{id}/service/start [post]
|
||||||
func (ac *ServiceControlController) startServer(c *fiber.Ctx) error {
|
func (ac *ServiceControlController) startServer(c *fiber.Ctx) error {
|
||||||
id := c.Params("id")
|
id := c.Params("id")
|
||||||
c.Locals("serverId", id)
|
c.Locals("serverId", id)
|
||||||
@@ -105,7 +105,7 @@ func (ac *ServiceControlController) startServer(c *fiber.Ctx) error {
|
|||||||
// @Failure 409 {object} error_handler.ErrorResponse "Service already stopped"
|
// @Failure 409 {object} error_handler.ErrorResponse "Service already stopped"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /v1/service-control/stop [post]
|
// @Router /v1/server/{id}/service/stop [post]
|
||||||
func (ac *ServiceControlController) stopServer(c *fiber.Ctx) error {
|
func (ac *ServiceControlController) stopServer(c *fiber.Ctx) error {
|
||||||
id := c.Params("id")
|
id := c.Params("id")
|
||||||
c.Locals("serverId", id)
|
c.Locals("serverId", id)
|
||||||
@@ -131,7 +131,7 @@ func (ac *ServiceControlController) stopServer(c *fiber.Ctx) error {
|
|||||||
// @Failure 404 {object} error_handler.ErrorResponse "Service not found"
|
// @Failure 404 {object} error_handler.ErrorResponse "Service not found"
|
||||||
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
// @Failure 500 {object} error_handler.ErrorResponse "Internal server error"
|
||||||
// @Security BearerAuth
|
// @Security BearerAuth
|
||||||
// @Router /v1/service-control/restart [post]
|
// @Router /v1/server/{id}/service/restart [post]
|
||||||
func (ac *ServiceControlController) restartServer(c *fiber.Ctx) error {
|
func (ac *ServiceControlController) restartServer(c *fiber.Ctx) error {
|
||||||
id := c.Params("id")
|
id := c.Params("id")
|
||||||
c.Locals("serverId", id)
|
c.Locals("serverId", id)
|
||||||
|
|||||||
@@ -31,9 +31,9 @@ func NewSystemController(routeGroups *common.RouteGroups) *SystemController {
|
|||||||
//
|
//
|
||||||
// @Summary Return service control status
|
// @Summary Return service control status
|
||||||
// @Description Return service control status
|
// @Description Return service control status
|
||||||
// @Tags service-control
|
// @Tags system
|
||||||
// @Success 200 {array} string
|
// @Success 200 {array} string
|
||||||
// @Router /v1/service-control [get]
|
// @Router /v1/system/health [get]
|
||||||
func (ac *SystemController) getFirst(c *fiber.Ctx) error {
|
func (ac *SystemController) getFirst(c *fiber.Ctx) error {
|
||||||
return c.SendString(configs.Version)
|
return c.SendString(configs.Version)
|
||||||
}
|
}
|
||||||
|
|||||||
785
swagger/docs.go
785
swagger/docs.go
@@ -11,7 +11,7 @@ const docTemplate = `{
|
|||||||
"title": "{{.Title}}",
|
"title": "{{.Title}}",
|
||||||
"contact": {
|
"contact": {
|
||||||
"name": "ACC Server Manager Support",
|
"name": "ACC Server Manager Support",
|
||||||
"url": "https://github.com/yourusername/acc-server-manager"
|
"url": "https://github.com/FJurmanovic/acc-server-manager"
|
||||||
},
|
},
|
||||||
"license": {
|
"license": {
|
||||||
"name": "MIT",
|
"name": "MIT",
|
||||||
@@ -22,199 +22,7 @@ const docTemplate = `{
|
|||||||
"host": "{{.Host}}",
|
"host": "{{.Host}}",
|
||||||
"basePath": "{{.BasePath}}",
|
"basePath": "{{.BasePath}}",
|
||||||
"paths": {
|
"paths": {
|
||||||
"/auth/login": {
|
"/v1/api/server": {
|
||||||
"post": {
|
|
||||||
"description": "Authenticate a user and receive a JWT token",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"Authentication"
|
|
||||||
],
|
|
||||||
"summary": "User login",
|
|
||||||
"parameters": [
|
|
||||||
{
|
|
||||||
"description": "Login credentials",
|
|
||||||
"name": "credentials",
|
|
||||||
"in": "body",
|
|
||||||
"required": true,
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"password": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"username": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "JWT token",
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"token": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"400": {
|
|
||||||
"description": "Invalid request body",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Invalid credentials",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/membership": {
|
|
||||||
"get": {
|
|
||||||
"security": [
|
|
||||||
{
|
|
||||||
"BearerAuth": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"description": "Get a list of all registered users",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"User Management"
|
|
||||||
],
|
|
||||||
"summary": "List all users",
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "List of users",
|
|
||||||
"schema": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"$ref": "#/definitions/model.User"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Unauthorized",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"403": {
|
|
||||||
"description": "Insufficient permissions",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"post": {
|
|
||||||
"security": [
|
|
||||||
{
|
|
||||||
"BearerAuth": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"description": "Create a new user account with specified role",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"User Management"
|
|
||||||
],
|
|
||||||
"summary": "Create a new user",
|
|
||||||
"parameters": [
|
|
||||||
{
|
|
||||||
"description": "User details",
|
|
||||||
"name": "user",
|
|
||||||
"in": "body",
|
|
||||||
"required": true,
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"password": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"role": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"username": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "Created user details",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/model.User"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"400": {
|
|
||||||
"description": "Invalid request body",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Unauthorized",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"403": {
|
|
||||||
"description": "Insufficient permissions",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"409": {
|
|
||||||
"description": "User already exists",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/server": {
|
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -305,6 +113,111 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/v1/auth/login": {
|
||||||
|
"post": {
|
||||||
|
"description": "Authenticate a user and receive a JWT token",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Authentication"
|
||||||
|
],
|
||||||
|
"summary": "User login",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"description": "Login credentials",
|
||||||
|
"name": "credentials",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "JWT token",
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"token": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Invalid credentials",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/auth/me": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get details of the currently authenticated user",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Authentication"
|
||||||
|
],
|
||||||
|
"summary": "Get current user details",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Current user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"/v1/lookup/car-models": {
|
"/v1/lookup/car-models": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
@@ -569,6 +482,361 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/v1/membership": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get a list of all registered users",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "List all users",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "List of users",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"post": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Create a new user account with specified role",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Create a new user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"description": "User details",
|
||||||
|
"name": "user",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"role": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Created user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"409": {
|
||||||
|
"description": "User already exists",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/membership/roles": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get a list of all available user roles",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Get all roles",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "List of roles",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/model.Role"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/membership/{id}": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get detailed information about a specific user",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Get user by ID",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "User details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid user ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"put": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Update user details by ID",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Update user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"description": "Updated user details",
|
||||||
|
"name": "user",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/service.UpdateUserRequest"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Updated user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body or ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"delete": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Delete a specific user by ID",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Delete user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"204": {
|
||||||
|
"description": "User successfully deleted"
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid user ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"/v1/server": {
|
"/v1/server": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
@@ -854,6 +1122,71 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"delete": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Delete an existing ACC server",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Server"
|
||||||
|
],
|
||||||
|
"summary": "Delete an ACC server",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "Server ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Deleted server details",
|
||||||
|
"schema": {
|
||||||
|
"type": "object"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid server data or ID",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "Server not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/server/{id}/config": {
|
"/v1/server/{id}/config": {
|
||||||
@@ -1086,27 +1419,7 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control": {
|
"/v1/server/{id}/service/restart": {
|
||||||
"get": {
|
|
||||||
"description": "Return service control status",
|
|
||||||
"tags": [
|
|
||||||
"service-control"
|
|
||||||
],
|
|
||||||
"summary": "Return service control status",
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "OK",
|
|
||||||
"schema": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/v1/service-control/restart": {
|
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1185,7 +1498,7 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/start": {
|
"/v1/server/{id}/service/start": {
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1270,7 +1583,7 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/stop": {
|
"/v1/server/{id}/service/stop": {
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1355,7 +1668,7 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/{service}": {
|
"/v1/server/{id}/service/{service}": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1463,6 +1776,26 @@ const docTemplate = `{
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"/v1/system/health": {
|
||||||
|
"get": {
|
||||||
|
"description": "Return service control status",
|
||||||
|
"tags": [
|
||||||
|
"system"
|
||||||
|
],
|
||||||
|
"summary": "Return service control status",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "OK",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"definitions": {
|
"definitions": {
|
||||||
@@ -1617,6 +1950,20 @@ const docTemplate = `{
|
|||||||
"type": "string"
|
"type": "string"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"service.UpdateUserRequest": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"roleId": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"securityDefinitions": {
|
"securityDefinitions": {
|
||||||
@@ -1632,7 +1979,7 @@ const docTemplate = `{
|
|||||||
// SwaggerInfo holds exported Swagger Info so clients can modify it
|
// SwaggerInfo holds exported Swagger Info so clients can modify it
|
||||||
var SwaggerInfo = &swag.Spec{
|
var SwaggerInfo = &swag.Spec{
|
||||||
Version: "1.0",
|
Version: "1.0",
|
||||||
Host: "localhost:3000",
|
Host: "https://acc.jurmanovic.com",
|
||||||
BasePath: "/api/v1",
|
BasePath: "/api/v1",
|
||||||
Schemes: []string{"http", "https"},
|
Schemes: []string{"http", "https"},
|
||||||
Title: "ACC Server Manager API",
|
Title: "ACC Server Manager API",
|
||||||
|
|||||||
@@ -9,7 +9,7 @@
|
|||||||
"title": "ACC Server Manager API",
|
"title": "ACC Server Manager API",
|
||||||
"contact": {
|
"contact": {
|
||||||
"name": "ACC Server Manager Support",
|
"name": "ACC Server Manager Support",
|
||||||
"url": "https://github.com/yourusername/acc-server-manager"
|
"url": "https://github.com/FJurmanovic/acc-server-manager"
|
||||||
},
|
},
|
||||||
"license": {
|
"license": {
|
||||||
"name": "MIT",
|
"name": "MIT",
|
||||||
@@ -17,202 +17,10 @@
|
|||||||
},
|
},
|
||||||
"version": "1.0"
|
"version": "1.0"
|
||||||
},
|
},
|
||||||
"host": "localhost:3000",
|
"host": "https://acc.jurmanovic.com",
|
||||||
"basePath": "/api/v1",
|
"basePath": "/api/v1",
|
||||||
"paths": {
|
"paths": {
|
||||||
"/auth/login": {
|
"/v1/api/server": {
|
||||||
"post": {
|
|
||||||
"description": "Authenticate a user and receive a JWT token",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"Authentication"
|
|
||||||
],
|
|
||||||
"summary": "User login",
|
|
||||||
"parameters": [
|
|
||||||
{
|
|
||||||
"description": "Login credentials",
|
|
||||||
"name": "credentials",
|
|
||||||
"in": "body",
|
|
||||||
"required": true,
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"password": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"username": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "JWT token",
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"token": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"400": {
|
|
||||||
"description": "Invalid request body",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Invalid credentials",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/membership": {
|
|
||||||
"get": {
|
|
||||||
"security": [
|
|
||||||
{
|
|
||||||
"BearerAuth": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"description": "Get a list of all registered users",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"User Management"
|
|
||||||
],
|
|
||||||
"summary": "List all users",
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "List of users",
|
|
||||||
"schema": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"$ref": "#/definitions/model.User"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Unauthorized",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"403": {
|
|
||||||
"description": "Insufficient permissions",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"post": {
|
|
||||||
"security": [
|
|
||||||
{
|
|
||||||
"BearerAuth": []
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"description": "Create a new user account with specified role",
|
|
||||||
"consumes": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"produces": [
|
|
||||||
"application/json"
|
|
||||||
],
|
|
||||||
"tags": [
|
|
||||||
"User Management"
|
|
||||||
],
|
|
||||||
"summary": "Create a new user",
|
|
||||||
"parameters": [
|
|
||||||
{
|
|
||||||
"description": "User details",
|
|
||||||
"name": "user",
|
|
||||||
"in": "body",
|
|
||||||
"required": true,
|
|
||||||
"schema": {
|
|
||||||
"type": "object",
|
|
||||||
"properties": {
|
|
||||||
"password": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"role": {
|
|
||||||
"type": "string"
|
|
||||||
},
|
|
||||||
"username": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "Created user details",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/model.User"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"400": {
|
|
||||||
"description": "Invalid request body",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"401": {
|
|
||||||
"description": "Unauthorized",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"403": {
|
|
||||||
"description": "Insufficient permissions",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"409": {
|
|
||||||
"description": "User already exists",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"500": {
|
|
||||||
"description": "Internal server error",
|
|
||||||
"schema": {
|
|
||||||
"$ref": "#/definitions/error_handler.ErrorResponse"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/server": {
|
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -303,6 +111,111 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/v1/auth/login": {
|
||||||
|
"post": {
|
||||||
|
"description": "Authenticate a user and receive a JWT token",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Authentication"
|
||||||
|
],
|
||||||
|
"summary": "User login",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"description": "Login credentials",
|
||||||
|
"name": "credentials",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "JWT token",
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"token": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Invalid credentials",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/auth/me": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get details of the currently authenticated user",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Authentication"
|
||||||
|
],
|
||||||
|
"summary": "Get current user details",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Current user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"/v1/lookup/car-models": {
|
"/v1/lookup/car-models": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
@@ -567,6 +480,361 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"/v1/membership": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get a list of all registered users",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "List all users",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "List of users",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"post": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Create a new user account with specified role",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Create a new user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"description": "User details",
|
||||||
|
"name": "user",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"role": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Created user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"409": {
|
||||||
|
"description": "User already exists",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/membership/roles": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get a list of all available user roles",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Get all roles",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "List of roles",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"$ref": "#/definitions/model.Role"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/v1/membership/{id}": {
|
||||||
|
"get": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Get detailed information about a specific user",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Get user by ID",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "User details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid user ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"put": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Update user details by ID",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Update user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"description": "Updated user details",
|
||||||
|
"name": "user",
|
||||||
|
"in": "body",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/service.UpdateUserRequest"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Updated user details",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/model.User"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid request body or ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"delete": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Delete a specific user by ID",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"User Management"
|
||||||
|
],
|
||||||
|
"summary": "Delete user",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "User ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"204": {
|
||||||
|
"description": "User successfully deleted"
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid user ID format",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "User not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"/v1/server": {
|
"/v1/server": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
@@ -852,6 +1120,71 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"delete": {
|
||||||
|
"security": [
|
||||||
|
{
|
||||||
|
"BearerAuth": []
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "Delete an existing ACC server",
|
||||||
|
"consumes": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"produces": [
|
||||||
|
"application/json"
|
||||||
|
],
|
||||||
|
"tags": [
|
||||||
|
"Server"
|
||||||
|
],
|
||||||
|
"summary": "Delete an ACC server",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"type": "string",
|
||||||
|
"description": "Server ID (UUID format)",
|
||||||
|
"name": "id",
|
||||||
|
"in": "path",
|
||||||
|
"required": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "Deleted server details",
|
||||||
|
"schema": {
|
||||||
|
"type": "object"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Invalid server data or ID",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"401": {
|
||||||
|
"description": "Unauthorized",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Insufficient permissions",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "Server not found",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "Internal server error",
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/error_handler.ErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/server/{id}/config": {
|
"/v1/server/{id}/config": {
|
||||||
@@ -1084,27 +1417,7 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control": {
|
"/v1/server/{id}/service/restart": {
|
||||||
"get": {
|
|
||||||
"description": "Return service control status",
|
|
||||||
"tags": [
|
|
||||||
"service-control"
|
|
||||||
],
|
|
||||||
"summary": "Return service control status",
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "OK",
|
|
||||||
"schema": {
|
|
||||||
"type": "array",
|
|
||||||
"items": {
|
|
||||||
"type": "string"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/v1/service-control/restart": {
|
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1183,7 +1496,7 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/start": {
|
"/v1/server/{id}/service/start": {
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1268,7 +1581,7 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/stop": {
|
"/v1/server/{id}/service/stop": {
|
||||||
"post": {
|
"post": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1353,7 +1666,7 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/v1/service-control/{service}": {
|
"/v1/server/{id}/service/{service}": {
|
||||||
"get": {
|
"get": {
|
||||||
"security": [
|
"security": [
|
||||||
{
|
{
|
||||||
@@ -1461,6 +1774,26 @@
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"/v1/system/health": {
|
||||||
|
"get": {
|
||||||
|
"description": "Return service control status",
|
||||||
|
"tags": [
|
||||||
|
"system"
|
||||||
|
],
|
||||||
|
"summary": "Return service control status",
|
||||||
|
"responses": {
|
||||||
|
"200": {
|
||||||
|
"description": "OK",
|
||||||
|
"schema": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"definitions": {
|
"definitions": {
|
||||||
@@ -1615,6 +1948,20 @@
|
|||||||
"type": "string"
|
"type": "string"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"service.UpdateUserRequest": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"password": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"roleId": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"username": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"securityDefinitions": {
|
"securityDefinitions": {
|
||||||
|
|||||||
@@ -103,11 +103,20 @@ definitions:
|
|||||||
username:
|
username:
|
||||||
type: string
|
type: string
|
||||||
type: object
|
type: object
|
||||||
host: localhost:3000
|
service.UpdateUserRequest:
|
||||||
|
properties:
|
||||||
|
password:
|
||||||
|
type: string
|
||||||
|
roleId:
|
||||||
|
type: string
|
||||||
|
username:
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
host: https://acc.jurmanovic.com
|
||||||
info:
|
info:
|
||||||
contact:
|
contact:
|
||||||
name: ACC Server Manager Support
|
name: ACC Server Manager Support
|
||||||
url: https://github.com/yourusername/acc-server-manager
|
url: https://github.com/FJurmanovic/acc-server-manager
|
||||||
description: API for managing Assetto Corsa Competizione dedicated servers
|
description: API for managing Assetto Corsa Competizione dedicated servers
|
||||||
license:
|
license:
|
||||||
name: MIT
|
name: MIT
|
||||||
@@ -115,130 +124,7 @@ info:
|
|||||||
title: ACC Server Manager API
|
title: ACC Server Manager API
|
||||||
version: "1.0"
|
version: "1.0"
|
||||||
paths:
|
paths:
|
||||||
/auth/login:
|
/v1/api/server:
|
||||||
post:
|
|
||||||
consumes:
|
|
||||||
- application/json
|
|
||||||
description: Authenticate a user and receive a JWT token
|
|
||||||
parameters:
|
|
||||||
- description: Login credentials
|
|
||||||
in: body
|
|
||||||
name: credentials
|
|
||||||
required: true
|
|
||||||
schema:
|
|
||||||
properties:
|
|
||||||
password:
|
|
||||||
type: string
|
|
||||||
username:
|
|
||||||
type: string
|
|
||||||
type: object
|
|
||||||
produces:
|
|
||||||
- application/json
|
|
||||||
responses:
|
|
||||||
"200":
|
|
||||||
description: JWT token
|
|
||||||
schema:
|
|
||||||
properties:
|
|
||||||
token:
|
|
||||||
type: string
|
|
||||||
type: object
|
|
||||||
"400":
|
|
||||||
description: Invalid request body
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"401":
|
|
||||||
description: Invalid credentials
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"500":
|
|
||||||
description: Internal server error
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
summary: User login
|
|
||||||
tags:
|
|
||||||
- Authentication
|
|
||||||
/membership:
|
|
||||||
get:
|
|
||||||
consumes:
|
|
||||||
- application/json
|
|
||||||
description: Get a list of all registered users
|
|
||||||
produces:
|
|
||||||
- application/json
|
|
||||||
responses:
|
|
||||||
"200":
|
|
||||||
description: List of users
|
|
||||||
schema:
|
|
||||||
items:
|
|
||||||
$ref: '#/definitions/model.User'
|
|
||||||
type: array
|
|
||||||
"401":
|
|
||||||
description: Unauthorized
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"403":
|
|
||||||
description: Insufficient permissions
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"500":
|
|
||||||
description: Internal server error
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
security:
|
|
||||||
- BearerAuth: []
|
|
||||||
summary: List all users
|
|
||||||
tags:
|
|
||||||
- User Management
|
|
||||||
post:
|
|
||||||
consumes:
|
|
||||||
- application/json
|
|
||||||
description: Create a new user account with specified role
|
|
||||||
parameters:
|
|
||||||
- description: User details
|
|
||||||
in: body
|
|
||||||
name: user
|
|
||||||
required: true
|
|
||||||
schema:
|
|
||||||
properties:
|
|
||||||
password:
|
|
||||||
type: string
|
|
||||||
role:
|
|
||||||
type: string
|
|
||||||
username:
|
|
||||||
type: string
|
|
||||||
type: object
|
|
||||||
produces:
|
|
||||||
- application/json
|
|
||||||
responses:
|
|
||||||
"200":
|
|
||||||
description: Created user details
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/model.User'
|
|
||||||
"400":
|
|
||||||
description: Invalid request body
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"401":
|
|
||||||
description: Unauthorized
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"403":
|
|
||||||
description: Insufficient permissions
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"409":
|
|
||||||
description: User already exists
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
"500":
|
|
||||||
description: Internal server error
|
|
||||||
schema:
|
|
||||||
$ref: '#/definitions/error_handler.ErrorResponse'
|
|
||||||
security:
|
|
||||||
- BearerAuth: []
|
|
||||||
summary: Create a new user
|
|
||||||
tags:
|
|
||||||
- User Management
|
|
||||||
/server:
|
|
||||||
get:
|
get:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -294,6 +180,73 @@ paths:
|
|||||||
summary: List all servers (API format)
|
summary: List all servers (API format)
|
||||||
tags:
|
tags:
|
||||||
- Server
|
- Server
|
||||||
|
/v1/auth/login:
|
||||||
|
post:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Authenticate a user and receive a JWT token
|
||||||
|
parameters:
|
||||||
|
- description: Login credentials
|
||||||
|
in: body
|
||||||
|
name: credentials
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
password:
|
||||||
|
type: string
|
||||||
|
username:
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: JWT token
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
token:
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
"400":
|
||||||
|
description: Invalid request body
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Invalid credentials
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"500":
|
||||||
|
description: Internal server error
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
summary: User login
|
||||||
|
tags:
|
||||||
|
- Authentication
|
||||||
|
/v1/auth/me:
|
||||||
|
get:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Get details of the currently authenticated user
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Current user details
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/model.User'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"404":
|
||||||
|
description: User not found
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Get current user details
|
||||||
|
tags:
|
||||||
|
- Authentication
|
||||||
/v1/lookup/car-models:
|
/v1/lookup/car-models:
|
||||||
get:
|
get:
|
||||||
consumes:
|
consumes:
|
||||||
@@ -461,6 +414,233 @@ paths:
|
|||||||
summary: Get available tracks
|
summary: Get available tracks
|
||||||
tags:
|
tags:
|
||||||
- Lookups
|
- Lookups
|
||||||
|
/v1/membership:
|
||||||
|
get:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Get a list of all registered users
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: List of users
|
||||||
|
schema:
|
||||||
|
items:
|
||||||
|
$ref: '#/definitions/model.User'
|
||||||
|
type: array
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"500":
|
||||||
|
description: Internal server error
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: List all users
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
|
post:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Create a new user account with specified role
|
||||||
|
parameters:
|
||||||
|
- description: User details
|
||||||
|
in: body
|
||||||
|
name: user
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
properties:
|
||||||
|
password:
|
||||||
|
type: string
|
||||||
|
role:
|
||||||
|
type: string
|
||||||
|
username:
|
||||||
|
type: string
|
||||||
|
type: object
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Created user details
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/model.User'
|
||||||
|
"400":
|
||||||
|
description: Invalid request body
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"409":
|
||||||
|
description: User already exists
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"500":
|
||||||
|
description: Internal server error
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Create a new user
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
|
/v1/membership/{id}:
|
||||||
|
delete:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Delete a specific user by ID
|
||||||
|
parameters:
|
||||||
|
- description: User ID (UUID format)
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"204":
|
||||||
|
description: User successfully deleted
|
||||||
|
"400":
|
||||||
|
description: Invalid user ID format
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"404":
|
||||||
|
description: User not found
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Delete user
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
|
get:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Get detailed information about a specific user
|
||||||
|
parameters:
|
||||||
|
- description: User ID (UUID format)
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: User details
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/model.User'
|
||||||
|
"400":
|
||||||
|
description: Invalid user ID format
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"404":
|
||||||
|
description: User not found
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Get user by ID
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
|
put:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Update user details by ID
|
||||||
|
parameters:
|
||||||
|
- description: User ID (UUID format)
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
- description: Updated user details
|
||||||
|
in: body
|
||||||
|
name: user
|
||||||
|
required: true
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/service.UpdateUserRequest'
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Updated user details
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/model.User'
|
||||||
|
"400":
|
||||||
|
description: Invalid request body or ID format
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"404":
|
||||||
|
description: User not found
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Update user
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
|
/v1/membership/roles:
|
||||||
|
get:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Get a list of all available user roles
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: List of roles
|
||||||
|
schema:
|
||||||
|
items:
|
||||||
|
$ref: '#/definitions/model.Role'
|
||||||
|
type: array
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"500":
|
||||||
|
description: Internal server error
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Get all roles
|
||||||
|
tags:
|
||||||
|
- User Management
|
||||||
/v1/server:
|
/v1/server:
|
||||||
get:
|
get:
|
||||||
consumes:
|
consumes:
|
||||||
@@ -557,6 +737,48 @@ paths:
|
|||||||
tags:
|
tags:
|
||||||
- Server
|
- Server
|
||||||
/v1/server/{id}:
|
/v1/server/{id}:
|
||||||
|
delete:
|
||||||
|
consumes:
|
||||||
|
- application/json
|
||||||
|
description: Delete an existing ACC server
|
||||||
|
parameters:
|
||||||
|
- description: Server ID (UUID format)
|
||||||
|
in: path
|
||||||
|
name: id
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
produces:
|
||||||
|
- application/json
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: Deleted server details
|
||||||
|
schema:
|
||||||
|
type: object
|
||||||
|
"400":
|
||||||
|
description: Invalid server data or ID
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"401":
|
||||||
|
description: Unauthorized
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"403":
|
||||||
|
description: Insufficient permissions
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"404":
|
||||||
|
description: Server not found
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
"500":
|
||||||
|
description: Internal server error
|
||||||
|
schema:
|
||||||
|
$ref: '#/definitions/error_handler.ErrorResponse'
|
||||||
|
security:
|
||||||
|
- BearerAuth: []
|
||||||
|
summary: Delete an ACC server
|
||||||
|
tags:
|
||||||
|
- Server
|
||||||
get:
|
get:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -792,20 +1014,7 @@ paths:
|
|||||||
summary: Update server configuration file
|
summary: Update server configuration file
|
||||||
tags:
|
tags:
|
||||||
- Server Configuration
|
- Server Configuration
|
||||||
/v1/service-control:
|
/v1/server/{id}/service/{service}:
|
||||||
get:
|
|
||||||
description: Return service control status
|
|
||||||
responses:
|
|
||||||
"200":
|
|
||||||
description: OK
|
|
||||||
schema:
|
|
||||||
items:
|
|
||||||
type: string
|
|
||||||
type: array
|
|
||||||
summary: Return service control status
|
|
||||||
tags:
|
|
||||||
- service-control
|
|
||||||
/v1/service-control/{service}:
|
|
||||||
get:
|
get:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -849,7 +1058,7 @@ paths:
|
|||||||
summary: Get service status
|
summary: Get service status
|
||||||
tags:
|
tags:
|
||||||
- Service Control
|
- Service Control
|
||||||
/v1/service-control/restart:
|
/v1/server/{id}/service/restart:
|
||||||
post:
|
post:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -899,7 +1108,7 @@ paths:
|
|||||||
summary: Restart a Windows service
|
summary: Restart a Windows service
|
||||||
tags:
|
tags:
|
||||||
- Service Control
|
- Service Control
|
||||||
/v1/service-control/start:
|
/v1/server/{id}/service/start:
|
||||||
post:
|
post:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -953,7 +1162,7 @@ paths:
|
|||||||
summary: Start a Windows service
|
summary: Start a Windows service
|
||||||
tags:
|
tags:
|
||||||
- Service Control
|
- Service Control
|
||||||
/v1/service-control/stop:
|
/v1/server/{id}/service/stop:
|
||||||
post:
|
post:
|
||||||
consumes:
|
consumes:
|
||||||
- application/json
|
- application/json
|
||||||
@@ -1033,6 +1242,19 @@ paths:
|
|||||||
summary: Return StateHistorys
|
summary: Return StateHistorys
|
||||||
tags:
|
tags:
|
||||||
- StateHistory
|
- StateHistory
|
||||||
|
/v1/system/health:
|
||||||
|
get:
|
||||||
|
description: Return service control status
|
||||||
|
responses:
|
||||||
|
"200":
|
||||||
|
description: OK
|
||||||
|
schema:
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
type: array
|
||||||
|
summary: Return service control status
|
||||||
|
tags:
|
||||||
|
- system
|
||||||
schemes:
|
schemes:
|
||||||
- http
|
- http
|
||||||
- https
|
- https
|
||||||
|
|||||||
Reference in New Issue
Block a user