把节点数据,接入你的系统。

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 联系我们

准备好接入了吗?

需要密钥或字段定义明细,联系我们即可。