DASS2 开发指南

适用版本：DASS2（真机实测基线 2.5.9.20241216，设备型号 IA-2230）
面向读者：需要基于 DASS2 做二次开发 / 系统集成的工程师

简介

DASS2 是一款运行在采集设备上的数据采集与上传管理应用：它管理采集服务、驱动、采集点与上传点，并与本地实时库（openPlant）联动。除了 Web 界面，DASS2 还对外提供一套 HTTP 接口（/v1/...，默认端口 8085），你可以据此自建程序，实现自动化点表导入、服务管理、数据查询等能力。

本开发指南就是这套 HTTP 接口的完整说明：如何鉴权、有哪些接口、字段怎么填、坑在哪里。

能做什么

用这套接口，你可以程序化完成：

• 自动化点表导入 / 导出——把上游系统的点表定期同步进 DASS2（本项目最主要的应用场景）
• 采集服务生命周期管理——查询、创建、改配置、启停、重启采集服务
• 驱动管理——查询驱动清单、读取驱动配置模板、上传驱动包
• 上传点管理——上传点的导入 / 导出 / 清空
• 设备信息与授权查询——设备型号、序列号、资源占用、License 余量
• 实时 / 历史数据读取——读取测点实时值与历史归档

文档结构

章节	内容	什么时候看
1. 概述	覆盖范围、术语与对象关系、阅读顺序	先看这个
2. 接入准备	服务地址、响应约定、鉴权机制、dasId 来源、自检清单	动手前必读
3. 快速开始	一条可复制执行的最小链路（含完整脚本）	想先跑通
4. 接口参考	八组接口的完整字段表与响应说明	查接口
5. 数据字典	点表 34 列全表、全部枚举、长度与数量限制	填点表时
6. 错误码	code 取值、底层错误码表、实测错误样本	调用失败时
7. 已知限制与坑	25 条按严重程度排序的坑与破坏性接口清单	上线前必读

三个先记住的结论

如果你只读一段，请读这段——这是二次开发最容易翻车的三点：

1. 鉴权要带两个 Cookie，缺一即 401

登录会下发 beegosessionID（会话）与 admin（同名用户 Cookie）两个 Cookie，必须同时携带。只用其中一个会得到 HTTP 401，而且响应体是 HTML（<a href="/">Unauthorized</a>）而不是 JSON，客户端必须按状态码处理。

如果你的程序与 DASS2 跑在同一台设备上，且该设备 require.local.login = true，则走 http://127.0.0.1:8085 可免登录直接调用，能省掉整个登录流程。

2. 成功判定是 code == 0 且 msg == "ok"

DASS2 的 msg 只有 "ok" / "error" 两个值，真正的错误原因在 data 里。而且存在 code:0 与 msg:"error" 并存的响应（如查询不存在的服务配置），所以不能只看 code。

3. 点表导入成功时 count 是 0

POST /v1/point/import/{dasId} 成功返回 {"code":0,"count":0,"data":[],"msg":"ok"}。count 不是导入条数——要拿实际条数，请在导入前后各查一次 GET /v1/point?SN=<服务名> 做差。

相关文档

文档	关系
《DASS2 使用手册》	界面操作说明。本指南中的界面路径仅用于帮你把接口动作与界面动作对应起来
《DASS2 部署手册》	设备部署与初始化
《DASS2 快速入门》	首次上手的完整流程