3x-ui/web/controller/api.go

63 lines
1.8 KiB
Go
Raw Normal View History

2023-02-09 11:18:06 -08:00
package controller
2023-05-18 14:01:05 -07:00
import (
"net/http"
"github.com/mhsanaei/3x-ui/v2/web/middleware"
2025-09-19 01:05:43 -07:00
"github.com/mhsanaei/3x-ui/v2/web/service"
"github.com/mhsanaei/3x-ui/v2/web/session"
2023-05-18 14:01:05 -07:00
"github.com/gin-gonic/gin"
)
2023-02-09 11:18:06 -08:00
2025-09-20 00:35:50 -07:00
// APIController handles the main API routes for the 3x-ui panel, including inbounds and server management.
2023-04-01 15:00:15 -07:00
type APIController struct {
BaseController
inboundController *InboundController
2025-09-08 16:22:43 -07:00
serverController *ServerController
2023-05-18 14:01:05 -07:00
Tgbot service.Tgbot
2023-02-09 11:18:06 -08:00
}
2025-09-20 00:35:50 -07:00
// NewAPIController creates a new APIController instance and initializes its routes.
func NewAPIController(g *gin.RouterGroup, customGeo *service.CustomGeoService) *APIController {
a := &APIController{}
a.initRouter(g, customGeo)
return a
2023-02-09 11:18:06 -08:00
}
// checkAPIAuth is a middleware that returns 404 for unauthenticated API requests
// to hide the existence of API endpoints from unauthorized users
func (a *APIController) checkAPIAuth(c *gin.Context) {
if !session.IsLogin(c) {
c.AbortWithStatus(http.StatusNotFound)
return
}
c.Next()
}
2025-09-20 00:35:50 -07:00
// initRouter sets up the API routes for inbounds, server, and other endpoints.
func (a *APIController) initRouter(g *gin.RouterGroup, customGeo *service.CustomGeoService) {
2025-09-08 16:22:43 -07:00
// Main API group
api := g.Group("/panel/api")
api.Use(a.checkAPIAuth)
api.Use(middleware.CSRFMiddleware())
2023-02-09 11:18:06 -08:00
2025-09-08 16:22:43 -07:00
// Inbounds API
inbounds := api.Group("/inbounds")
a.inboundController = NewInboundController(inbounds)
2025-09-08 16:22:43 -07:00
// Server API
server := api.Group("/server")
a.serverController = NewServerController(server)
NewCustomGeoController(api.Group("/custom-geo"), customGeo)
2025-09-08 16:22:43 -07:00
// Extra routes
api.GET("/backuptotgbot", a.BackuptoTgbot)
}
2023-05-18 14:01:05 -07:00
2025-09-20 00:35:50 -07:00
// BackuptoTgbot sends a backup of the panel data to Telegram bot admins.
2025-09-08 16:22:43 -07:00
func (a *APIController) BackuptoTgbot(c *gin.Context) {
2023-05-20 15:59:27 -07:00
a.Tgbot.SendBackupToAdmins()
2023-05-18 14:01:05 -07:00
}