Infrastructure endpoints (Admin API)
11 FeatherPanel Admin API endpoints from admin/kpi/infrastructure.php: methods, paths, auth, permissions, rate limits, parameters and responses.
Last synced from FeatherPanel 15b94e9 on .
On this page
Defined in backend/app/routes/admin/kpi/infrastructure.php. Authentication used here: Admin. Read Authentication for how to send credentials and Rate limits and errors for the response envelope.
Paths, methods, permissions and rate limits come from the route file. Summaries, parameters and response codes come from the OpenAPI annotations on the controllers; endpoints without annotations show only what the route file declares.
Endpoints
GET/api/admin/analytics/locations/overview
Get locations overview Retrieve statistics about locations.
curl -X GET "$PANEL_URL/api/admin/analytics/locations/overview" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Locations overview retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/nodes/overview
Get nodes overview Retrieve statistics about nodes.
curl -X GET "$PANEL_URL/api/admin/analytics/nodes/overview" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Nodes overview retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/nodes/by-location
Get nodes by location Retrieve node distribution across locations.
curl -X GET "$PANEL_URL/api/admin/analytics/nodes/by-location" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Nodes by location retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/nodes/resources
Get node resource allocation Retrieve resource allocation statistics for all nodes.
curl -X GET "$PANEL_URL/api/admin/analytics/nodes/resources" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Node resources retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/servers/by-node
Get servers by node Retrieve server distribution across nodes.
curl -X GET "$PANEL_URL/api/admin/analytics/servers/by-node" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Servers by node retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/allocations/overview
Get allocations overview Retrieve statistics about allocations.
curl -X GET "$PANEL_URL/api/admin/analytics/allocations/overview" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Allocations overview retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/allocations/by-node
Get allocations by node Retrieve allocation distribution across nodes.
curl -X GET "$PANEL_URL/api/admin/analytics/allocations/by-node" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Allocations by node retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/ports/usage
Get port usage statistics Retrieve statistics about most used ports.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | no | Number of top ports to retrieve (default: 10) |
curl -X GET "$PANEL_URL/api/admin/analytics/ports/usage" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Port usage retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/ips/usage
Get IP usage statistics Retrieve statistics about most used IP addresses.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | no | Number of top IPs to retrieve (default: 10) |
curl -X GET "$PANEL_URL/api/admin/analytics/ips/usage" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 IP usage retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/databases/overview
Get databases overview Retrieve statistics about database hosts.
curl -X GET "$PANEL_URL/api/admin/analytics/databases/overview" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Databases overview retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions
GET/api/admin/analytics/infrastructure/dashboard
Get comprehensive infrastructure dashboard Retrieve all infrastructure analytics data.
curl -X GET "$PANEL_URL/api/admin/analytics/infrastructure/dashboard" \
-H "Authorization: Bearer $FEATHERPANEL_API_KEY" \
-H "Accept: application/json"Responses: 200 Infrastructure dashboard retrieved successfully · 401 Unauthorized · 403 Forbidden - Insufficient permissions