把节点数据,接入你的系统。
REST API · JSON 响应 · Token 鉴权——为面板平台、服务商与开发者准备的数据接口。
概述
Pi Admin REST API 提供节点与运行数据的编程访问。所有接口使用 HTTPS,返回 JSON;通过 Authorization 请求头携带密钥完成鉴权,密钥由站点运营方签发,请像保管密码一样保管它。
鉴权方式
Authorization: Bearer <你的密钥>
快速开始
用一条 curl 命令拿到第一份数据:
curl -sS "/api/nodes?page=1&pageSize=20" \ -H "Authorization: Bearer TOKEN" \ -H "Accept: application/json"
核心接口
GET
/api/nodes返回当前用户可访问的节点列表,支持分页和状态筛选。
GET
/api/nodes/:id返回单个节点的基本信息和当前运行状态。
GET
/api/nodes/:id/stats返回节点指定时间范围内的统计数据。
错误码
401未携带或密钥无效——检查 Authorization 请求头
403权限不足——该接口需要更高权限的密钥
429触发限流——请降低请求频率,或联系我们申请提额
5xx服务端异常——请携带请求 ID 联系我们
准备好接入了吗?
需要密钥或字段定义明细,联系我们即可。
