跳转至

08. 运维与管理接口

1. 用户审批(Admin)

GET /api/approvals/pending

参数: - status=0|1|2 - page - limit

返回包含用户基础信息和证书列表(certs)。

PUT /api/approvals/:id/approve

请求:

{ "status": 1, "note": "审核通过" }
  • status=1 通过
  • status=2 拒绝

2. 操作证审批(Admin)

GET /api/certificate-approvals

参数:status=-1|0|1|2pagelimit

PUT /api/operator-certificates/:id/approve

请求:

{ "status": 1, "note": "证件清晰,予以通过" }

3. 中继台与服务器(Admin)

中继台

  • GET /api/relays
  • GET /api/relay/list(兼容)
  • POST /api/relay/create
  • POST /api/relay/update
  • POST /api/relay/delete

中继台请求示例(create/update):

{
  "id": 1,
  "name": "深圳 439.500",
  "up_freq": "431.500",
  "down_freq": "439.500",
  "send_ctss": "88.5",
  "recive_ctss": "88.5",
  "location": "广东省 深圳市 南山区",
  "status": 1,
  "note": "主站"
}

删除请求:

{ "id": 1 }

服务器

  • GET /api/servers
  • GET /api/server/list(兼容)
  • POST /api/server/create
  • POST /api/server/update
  • POST /api/server/delete

删除请求:

{ "id": 2 }

4. 操作日志(Admin)

  • GET /api/operatorlog/list
  • GET /api/operatorlog/stats

/list 参数:pagepage_sizeevent_type

5. 缓存监控(Admin)

  • GET /api/cache/metrics
  • POST /api/cache/metrics/reset
  • POST /api/cache/clear

指标返回示例:

{
  "code": 200,
  "message": "success",
  "data": {
    "l1_hits": 1234,
    "l1_misses": 321,
    "l1_hit_rate": 0.79,
    "total_requests": 1555,
    "invalidations": 42,
    "errors": 0,
    "latency": { "get_avg_ns": 1200, "set_avg_ns": 2400, "del_avg_ns": 1800 },
    "uptime_seconds": 98765
  }
}

6. 公开中继查询(无登录)

GET /api/public/relays?location=广东省

返回:

{ "code": 200, "message": "成功", "data": { "items": [] } }