8. 更新日志

版本号	发布时间	更新内容
v1.0	2026-09-24	首版发布。对照 DASS2 后端 `dasserver`（Go + beego v1）源码整理接口契约，并对真机 `2.5.9.20241216`（型号 `IA-2230`）完成只读实测校准。内容覆盖：登录与鉴权、采集服务管理、驱动管理、采集测点、上传点、系统信息与资源、实时与历史数据、系统运维八组接口；新增数据字典（含点表 34 列全表与全部枚举）、错误码、已知限制与坑（25 条）。

关于本版的实测基线

本手册的字段名、枚举、长度限制与错误响应，均按以下方式交叉验证：

来源	用途
`dasserver` 源码（`routers/router.go` + `controllers/` + `consts/` + `models/`）	接口契约、参数键名、枚举取值、校验规则
`dasserver-ui`（`src/config/i18N.js`）	字段中文名
真机 `192.168.50.121:8085`（DASS2 `2.5.9.20241216`，型号 `IA-2230`）	只读实测：登录、服务列表、服务配置、驱动列表与配置、测点/上传点查询、模板下载、系统信息与配置、授权信息、错误响应样本

只读承诺：实测未执行任何写操作——未导入/删除/清空任何测点，未启停任何服务，未修改任何配置。实测结束后已核对设备服务状态与实测前一致。

已知的口径差异（与既有资料）

项	既有资料	本手册（实测/源码）
`/v1/point/import/{id}` 的 `count`	「导入的测点数量」	成功时恒为 `0`；条数需导入前后对比 `GET /v1/point?SN=<服务名>` 的 `count`
`GET /v1/point/{id}` 的 `{id}`	未说明	是测点 UID，不是 `dasId`；按服务查测点须用 `?SN=<服务名>`
`GET /v1/point` 的 `limit`/`offset`	未说明	语义与直觉相反：`limit`=起始行偏移、`offset`=每页条数（后端拼 `LIMIT <limit>,<offset>`）
`POST /v1/point/forceDelete/{id}`	强制删除测点	空实现，不删任何数据却返回「脏数据清除成功」
`/v1/calcModel/gethistorybyid`	视为历史数据查询接口	返回伪造的随机数据（点名恒为 `TEST_POINT_0005`），与传入的测点 ID 无关。真实历史数据请用 `/v1/opconsole/gethistorybyid(s)`
`/v1/opconsole/gethistorybyid(s)` 的时间参数	未说明	推荐日期时间字符串（`2017-08-30 17:00:00`）；数字 Unix 秒也可用。采样被写死为 `mode='span' interval=1`（1 秒 1 点），且无条数上限
`/v1/mqtt/*` 是否免登录	曾假设为免登录	四条全部需要登录（已核实 `edge_iothub` 也是先登录再调用）
`/v1/system/conf`	—	会返回实时库明文口令与云平台口令，属敏感接口
权限模型	—	`auth` 表只控制前端菜单可见性，没有任何接口级 RBAC：任何登录用户都能调用全部 `/v1/system/*`
成功判定	`code == 0`	`code == 0 && msg == "ok"`（存在 `code:0` + `msg:"error"` 的响应）
点名长度上限	参见附录《测点属性表》	实测 `MaxPnLength = 32`（`conf/dasserver.conf` 的 `pn.length=32`）
鉴权	Cookie 认证	Session + 同名用户 Cookie 双重校验，缺一即 401；失败返回 HTML 而非 JSON
HTTPS / 管理端口	`app.conf` 配置 `8010` / `8088`	实测均未监听，仅 `8085` 开放