电子标签标签注册
通过手动触发电子标签注册到系统，注册成功就可以进行功能测试。
仓储24代注册
注册成功显示rssi:-xxdB如下：
绝对值越小信号越差，一般0 ~ -75dB都可以正常通讯
查询电子标签信息接口
接口描述
查询注册到系统的电子标签的信息。
接口信息
接口地址：192.168.1.200/wms/associate/queryTagsInRouterId
请求类型：application/json
请求方式：post
接口备注：根据基站id查询电子标签信息
调试工具：ApiPost
请求体参数说明：
| 参数名称 | 示例值 | 类型 | 参数说明 |
|---|---|---|---|
| 基站id的集合，传空则查全部 |
请求示例：
| [1] |
|---|
返回参数说明：(200)成功
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| datalist | Object | 标签信息的集合 | |
| datalist.hardwareVersion | 4.5 | String | 硬件版本号 |
| datalist.height | 128 | Number | 分辨率（高） |
| datalist.mac | 99.26.17.85 | String | 标签id号 |
| datalist.manufacture | CoreWind31 | String | 型号标识 |
| datalist.power | 100 | Number | 标签电量 |
| datalist.productionBatch | 20-08-29 | String | 生产批次 |
| datalist.routerId | 1 | Number | 绑定基站ID |
| datalist.rssi | -21 | Number | 信号强度 |
| datalist.screenType | 1 | Number | 屏幕类型 |
| datalist.serialNumber | CNSHZH1000 | String | 序列号 |
| datalist.shopNumber | A0015 | String | 所属店铺 |
| datalist.showStyle | 拣货模板单列 | String | 使用模板名称 |
| datalist.softwareVersion | 7.0 | String | 软件版本号 |
| datalist.state | true | String | 在线状态 |
| datalist.status | 4 | Number | 更新状态 |
| datalist.tagRegisterEN | 1 | Number | 允许标签注册开关 |
| datalist.width | 296 | Number | 分辨率（宽） |
| resultCode | 10 | Number | 返回码 |
| resultMsg | success | String | 接口响应信息 |
返回示例：(200)成功
| { |
|---|
返回参数说明：(201)失败
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| 无请求参数 KEY/VALUE 类型 |
根据模板刷新屏幕接口
接口描述
墨水屏管理系统配置模板，然后根据设计的模板调用接口
接口信息
接口地址：
http://192.168.1.200/wms/associate/updateScreen
http://192.168.1.200/wms/associate/refreshMovingTags (移动场景专用)
请求类型：application/json
请求方式：post
接口备注：暂无描述
调试工具：ApiPost
请求体参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| mac | 99.26.17.85 | String | 是 | 标签id号 |
| mappingtype | 694 | Number | 否 | 映射类型，可不传 |
| styleid | 30 | Number | 是 | 模板id |
| ledrgb | 0 | String | 是 | 亮灯颜色red，ledrgb =“ff0000”;green，ledrgb=“ff00”;blue，ledrgb=“ff”;yellow，ledrgb=“ffff00”;white，ledrgb=“ffffff”;purple，ledrgb= “ff00ff”;light blue，ledrgb= “ffff”;no color, ledrgb=“0”不需要亮灯传0 |
| ledstate | 0 | String | 是 | 亮灯模式：0，常亮；1，快闪；2，慢闪；3，灭灯； |
| outtime | 0 | String | 是 | 亮灯自动超时时间，0: 一直亮；n: n秒后自动熄灭； |
| startMachine | PE1-01 | String | 否 | 自定义添加，起点工序台 |
| endMachine | PE2-05 | String | 否 | 自定义添加，终点工序台 |
| taskStartTime | 2022-11-11 9:00 | String | 否 | 自定义添加，任务开始时间 |
| basketsQuantity | 20 | number | 否 | 自定义添加，花篮数量 |
| arrow | 空 | 字符串 | 是 | 箭头图标，不传值即可 |
| power | 空 | number | 否 | 自动显示可不传 |
| rssi | 空 | number | 否 | 自动显示可不传 |
请求示例：
| [ |
|---|
返回参数说明：(200)成功
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| 无请求参数 KEY/VALUE 类型 |
返回示例：(200)成功
| true |
|---|
返回参数说明：(201)失败
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| 无请求参数 KEY/VALUE 类型 |
更新屏幕结果回调
接口描述
更新屏幕的结果反馈，异步
接口信息
回调请求类型：application/json
回调请求方式：post
回调请求备注：墨水服务器为调用方，客户软件接收回调
回调请求参数示例：
| {"cmdtoken":"cmdtoken","lednum":0,"mac":"99.88.29.82","message":"数据成功","power":100,"result":true} |
|---|
回调请求参数说明：
| 参数名称 | 示例值 | 类型 | 参数说明 |
|---|---|---|---|
| mac | 99.89.40.57 | string | 触发按键的标签ID号 |
| result | true | int | true,更新成功false,更新失败 |
| power | 100 | int | 墨水屏当前电量 |
| message | 数据成功 | string | 提示信息 |
| lednum | 0 | int | 不处理 |
| cmdtoken | string | 不处理 |
回调接口设置
| 描述 | url地址 |
|---|---|
| updateTagResult | 客户自己的回调接口地址 |
单独点灯接口
接口描述
单独点灯接口
接口信息
接口地址：
http://192.168.1.200/wms/associate/lightTagsLed
http://192.168.1.200/wms/associate/lightMovingTagsLed (移动场景专用)
请求类型：application/json
请求方式：post
接口备注：暂无描述
调试工具：ApiPost
请求体参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| mac | 99.26.17.85 | string | 是 | 指示灯所在标签的mac地址 |
| lednum | 694 | int | 否 | 需要控制哪个指示灯（编号：1~4） |
| timeout | 30 | int | 是 | 对应时间多少秒后标签自动熄灭；默认传0不自动熄灭 |
| ledrgb | 0 | string | 是 | 亮灯颜色red，ledrgb =“ff0000”;green，ledrgb=“ff00”;blue，ledrgb=“ff”;yellow，ledrgb=“ffff00”;white，ledrgb=“ffffff”;purple，ledrgb= “ff00ff”;light blue，ledrgb= “ffff”;no color, ledrgb=“0”不需要亮灯传0 |
| ledmode | 0 | int | 是 | 0：标签指示灯常亮；1：标签指示灯快闪；2：标签指示灯慢闪；3：灭灯；4：全灭； |
| cmdtoken | 0 | string | 是 | 扩展参数，可不传 |
| reserve | PE1-01 | string | 否 | 预留 |
请求示例：
| [ |
|---|
返回参数说明：(200)成功
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| 无请求参数 KEY/VALUE 类型 |
返回示例：(200)成功
| true |
|---|
返回参数说明：(201)失败
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| 无请求参数 KEY/VALUE 类型 |
单独点灯接口结果回调
接口描述：
仓储24代电子标签点灯结果回调接口介绍；
接口信息
点灯结果回调接口
回调请求类型：application/json
回调请求方式：post
回调参数格式：json object
回调请求备注：墨水服务器为调用方，客户软件接收回调
回调请求参数示例：
| {"mac":"99.99.08.51","result":true,"power":100,"lednum":1,"cmdtoken":"55555","message":"数据成功"} |
|---|
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|---|---|---|
| mac | 99.99.08.51 | string | 触发按键的标签ID号 |
| power | 100 | int | 标签剩余电量（0~100） |
| result | true | bool | true:点亮成功false:点亮失败 |
| lednum | 1 | int | 亮灯编号 |
| cmdtoken | string | 返回调用请求传入的cmdtoken,可不使用 | |
| message | 数据成功 | string | 数据成功；数据失败；数据发送超时；唤醒失败；基站不在线；数据异常；数据格式不正确，解析失败；参数格式不正确或参数不全，无法执行标签不存在； |
回调接口设置
| 描述 | url地址 |
|---|---|
| ctrlShelfIndicatorResult | 客户自己的回调接口地址 |
按键事件回调
接口描述：
仓储24代电子标签按键事件回调接口介绍
接口信息
按键事件回调接口
回调请求类型：application/json
回调请求方式：post
回调参数格式：json object
回调请求备注：墨水服务器为调用方，客户软件接收回调
回调请求参数示例：
| {"mac":"92.91.34.99","result":0} |
|---|
| 参数名称 | 示例值 | 类型 | 参数说明 |
|---|---|---|---|
| mac | 92.91.34.99 | string | 触发按键的标签ID号 |
| result | 0 | int | result=0，右下按键；result=1，右中按键；result=3，右上按键； |
回调接口设置
| 描述 | url地址 |
|---|---|
| enterKey | 客户自己的回调接口地址 |
基站状态上报回调
接口描述：
基站状态上报回调接口介绍；
接口信息
基站状态上报回调接口
回调请求类型：application/json
回调请求方式：post
回调参数格式：json object
回调请求备注：墨水服务器为调用方，客户软件接收回调
回调请求参数示例：
| { |
|---|
请求体参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| id | 1820 | int | 基站ID编号 | |
| ip | "192.168.1.244" | string | 基站IP地址 | |
| frequency | 460 | int | 基站通讯频率(显示的频率比实际频率小435) | |
| hardVersion | "8.1.2" | string | 硬件版本号 | |
| masterRouterMac | 0 | int | ||
| productBatch | "2021-11-01" | string | 生产批次 | |
| serialNumber | "CNSHZH1844" | string | 序列号 | |
| shortPeriod | 0.5 | float | 短周期 | |
| softVersion | "8.3.3" | string | 软件版本号 | |
| state | 1 | int | 基站状态 | |
| tagRegisterEN | 1 | int | 允许标签注册开关1：开启0：关闭 |
回调接口设置
| 描述 | url地址 |
|---|---|
| routerLoginAck | 客户自己的回调接口地址 |
标签注册事件回调
接口描述：
仓储24代电子标签注册事件回调接口介绍；
接口信息
按键事件回调接口
回调请求类型：application/json
回调请求方式：post
回调参数格式：json object
回调请求备注：墨水服务器为调用方，客户软件接收回调
回调请求参数示例：
| { |
|---|
请求体参数说明：
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|---|
| mac | "99.88.29.86" | int | 电子标签ID编号 | |
| power | 100 | int | 标签剩余电量 | |
| routerId | 460 | int | 所属基站的ID | |
| rssi | "8.1.2" | string | 信号强度 | |
| screenType | 1 | int | 屏幕类型 | |
| height | 300 | string | 屏幕高度 | |
| width | 400 | string | 屏幕宽度 | |
| status | 4 | int | 更新状态 | |
| state | true | int | 基站状态 | |
| showStyle | "默认模板46" | string | 使用的模板名称 | |
| softwareVersion | "7.2" | string | 软件版本号 | |
| hardwareVersion | "4.7" | string | 硬件版本号 | |
| serialNumber | "CNSHZH1000" | string | 序列号 | |
| shopNumber | "A0001" | string | 店铺编号 | |
| productionBatch | "20-11-05" | string | 生产批次 | |
| manufacture | "CoreWind24" | string | 供应商 | |
| tagRegisterEN | 1 | int | 允许标签注册开关1：开启0：关闭 |
回调接口设置
| 描述 | url地址 |
|---|---|
| tagRegisterAck | 客户自己的回调接口地址 |
![[计算机入门] 搜索文件](https://img-blog.csdnimg.cn/c5dfb32721a040f7a0d9ce827e5db7e2.png)
