Files
ez-api/internal/api/admin_handler.go
RC-CHN 770a9fef2b feat: Add Swagger documentation for admin and master API endpoints
- Added Swagger documentation for the following admin endpoints:
  - Create a new master tenant
  - Create a new provider
  - Register a new model
  - List all models
  - Update a model
  - Force sync snapshot
  - Ingest logs

- Added Swagger documentation for the master endpoint:
  - Issue a child key

- Updated go.mod and go.sum to include necessary dependencies for Swagger.
2025-12-05 15:01:35 +08:00

73 lines
2.1 KiB
Go

package api
import (
"net/http"
"github.com/ez-api/ez-api/internal/service"
"github.com/gin-gonic/gin"
)
type AdminHandler struct {
masterService *service.MasterService
syncService *service.SyncService
}
func NewAdminHandler(masterService *service.MasterService, syncService *service.SyncService) *AdminHandler {
return &AdminHandler{masterService: masterService, syncService: syncService}
}
type CreateMasterRequest struct {
Name string `json:"name" binding:"required"`
Group string `json:"group" binding:"required"`
MaxChildKeys int `json:"max_child_keys"`
GlobalQPS int `json:"global_qps"`
}
// CreateMaster godoc
// @Summary Create a new master tenant
// @Description Create a new master account (tenant)
// @Tags admin
// @Accept json
// @Produce json
// @Security AdminAuth
// @Param master body CreateMasterRequest true "Master Info"
// @Success 201 {object} gin.H
// @Failure 400 {object} gin.H
// @Failure 500 {object} gin.H
// @Router /admin/masters [post]
func (h *AdminHandler) CreateMaster(c *gin.Context) {
var req CreateMasterRequest
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
// Use defaults if not provided
if req.MaxChildKeys == 0 {
req.MaxChildKeys = 5
}
if req.GlobalQPS == 0 {
req.GlobalQPS = 3
}
master, rawMasterKey, err := h.masterService.CreateMaster(req.Name, req.Group, req.MaxChildKeys, req.GlobalQPS)
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to create master key", "details": err.Error()})
return
}
if err := h.syncService.SyncMaster(master); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"error": "failed to sync master key", "details": err.Error()})
return
}
c.JSON(http.StatusCreated, gin.H{
"id": master.ID,
"name": master.Name,
"group": master.Group,
"master_key": rawMasterKey, // Only show this on creation
"max_child_keys": master.MaxChildKeys,
"global_qps": master.GlobalQPS,
})
}