快速开始

从获取账号到完成首次请求，开启你的 THWater 数据集成之旅。

01 获取专用账号

已安装设备的用户，请联系项目工程师、销售服务人员或项目经理获取数据对接专用账号；尚未安装设备的用户，可申请演示项目和临时账号进行对接。

请在服务端配置环境变量 THWATER_USERNAME 和 THWATER_PASSWORD，不要将账号密码写入前端代码或提交到代码仓库。

02 获取访问 Token

通过 POST /api/permission/token 提交用户名与密码。请求体使用 application/x-www-form-urlencoded 格式。

1curl --request POST \2  'https://dev.thuwater.com/api/permission/token' \3  --header 'Content-Type: application/x-www-form-urlencoded' \4  --data-urlencode "username=$THWATER_USERNAME" \5  --data-urlencode "password=$THWATER_PASSWORD"

响应中包含 token、validDate、valid 以及授权项目和安装位置等信息。请检查 valid，并根据 validDate 在 Token 过期时及时更新。

03 同步你的监测数据

获取 Token 后，可先查询授权安装位置与设备数据说明，再根据业务需要选择历史数据、最新数据或实时 PULL 同步接口。具体参数及 Token 传递方式请以各接口文档为准。