POWER O&M OPEN API · v1

电力运维数据开放接口

面向移动巡检、监控大屏、集团数据中台与第三方系统，提供设备台账、实时遥测、告警事件、巡检任务、检修工单与备件预警的只读数据服务，以及告警确认写操作。

https://api.przliz.wj2.cn/v1

RESTfulJSONBearer TokenUTF-8CORS 已启用

接入说明

接口采用 HTTPS + JSON 传输，所有请求与响应均使用 UTF-8 编码。除令牌签发接口外，其余接口均需携带访问令牌。

项目	说明
Base URL	https://api.przliz.wj2.cn/v1
Content-Type	application/json; charset=utf-8
认证方式	Authorization: Bearer <token> 或 X-API-Token
令牌有效期	7 天（可重新签发）
调用频率	建议单令牌不超过 60 次/分钟

令牌等同于账号凭证，请勿写入前端代码或公开仓库。生产环境建议由服务端代理调用，并定期轮换令牌。

鉴权方式

POST/v1/auth/token签发访问令牌

参数	类型	必填	说明
username	string	是	系统账号
password	string	是	登录密码

curl -X POST "https://api.przliz.wj2.cn/v1/auth/token" \
  -H "Content-Type: application/json" \
  -d '{"username":"your-account","password":"your-password"}'

{
  "code": 0,
  "message": "success",
  "data": {
    "token": "9f3a7c1e5b2d4806...",
    "token_type": "Bearer",
    "expires_in": 604800,
    "user": { "username": "your-account", "real_name": "张伟" }
  }
}

curl "https://api.przliz.wj2.cn/v1/overview" \
  -H "Authorization: Bearer <your-token>"

响应结构

所有接口返回统一信封结构，code=0 表示成功，非 0 表示业务错误。HTTP 状态码同步反映请求结果。

{
  "code": 0,
  "message": "success",
  "data": { },
  "timestamp": "2026-10-29T10:20:30+08:00"
}

设备台账

GET/v1/devices分页查询设备

参数	类型	必填	说明
station	int	否	站所 ID
status	string	否	运行中 / 告警 / 检修中 / 停运
keyword	string	否	设备名称或编号模糊匹配
page / limit	int	否	分页参数，limit 最大 100

curl "https://api.przliz.wj2.cn/v1/devices?station=1&limit=20" -H "Authorization: Bearer <token>"

GET/v1/devices/{id}设备详情（含实时遥测与遥信）

返回设备档案、最新遥测快照、遥信状态与健康度评分。

实时遥测

GET/v1/telemetry/latest最新遥测快照

参数	类型	必填	说明
device_id	int	否	不传则返回全部设备最新快照

{
  "code": 0,
  "data": {
    "device_id": 42,
    "ts": "2026-10-29 10:15:00",
    "ua": 110.02, "ia": 268.4, "p": 48.21,
    "temp": 63.5, "load_rate": 76.3, "pf": 0.958
  }
}

GET/v1/telemetry/history历史遥测曲线

参数	类型	必填	说明
device_id	int	是	设备 ID
hours	int	否	回溯小时数，默认 24，最大 168

告警事件

GET/v1/alarms告警列表

参数	类型	必填	说明
status	string	否	待确认 / 处理中 / 已恢复 / 已关闭 / 误报
level	string	否	紧急 / 重要 / 一般 / 提示
limit	int	否	默认 20，最大 100

POST/v1/alarms/{id}/ack确认告警（写操作）

将指定告警置为「处理中」，并记录确认人与时间。该操作会写入告警处置链路与审计日志。

curl -X POST "https://api.przliz.wj2.cn/v1/alarms/128/ack" -H "Authorization: Bearer <token>"

巡检任务

GET/v1/inspection/tasks在办巡检任务

返回待派发、待执行、执行中与已逾期任务，包含执行人、班组、截止时间与完成进度，适用于移动巡检端任务拉取。

curl "https://api.przliz.wj2.cn/v1/inspection/tasks" -H "Authorization: Bearer <token>"

检修工单

GET/v1/workorders最近 50 张工单

返回工单编号、标题、类型、等级、状态、关联设备、申请人与负责人，便于集团侧汇总抢修与检修进度。

备件预警

GET/v1/spares/alerts低于安全库存的备件

返回备件名称、型号、当前库存、安全库存、上限库存与供应商，可对接采购系统自动生成补货计划。

运维报表

GET/v1/reports/summary告警与缺陷按日汇总

参数	类型	必填	说明
from	date	否	开始日期，默认本月 1 日
to	date	否	结束日期，默认今日

错误码

code	HTTP	说明
0	200	请求成功
400	400	请求参数错误
401	401	令牌缺失、无效或已过期
403	403	账号被禁用或无访问权限
404	404	接口或资源不存在
405	405	请求方法不支持