仓储1、10、11代电子标签接口文档

一、标签注册

1、仓储1代注册

侧面按钮连按三次，

注册成功：红灯变绿灯

​

2、仓储10代注册

右下角+左下角组合按键触发注册

注册成功：右上角绿灯变红灯

​

3、仓储11代注册

磁体靠近条码附近，触发标签注册到系统

注册成功：闪红灯边绿灯

​

4、仓储15代注册

磁体靠近灯珠与条码中间区域，触发标签注册到系统

注册成功：闪红灯变闪绿灯，之后熄灭

二、查询电子标签信息接口

接口地址：192.168.1.200/wms/associate/getTagsMsg

请求类型：multipart/form-data

请求方式：get

接口备注：暂无描述

调试工具：ApiPost

请求体参数说明：

参数名称	示例值	类型	参数说明
无请求参数 KEY/VALUE 类型

[ { "lastOpreateTime": "2022-03-24 04:53:15", "mac": "99.89.40.57", "power": 100, "routerid": "CWR000001", "rssi": -57, "showStyle": "Picking Template" }, { "lastOpreateTime": "2022-03-24 04:53:29", "mac": "99.89.75.63", "power": 97, "routerid": "CWR000001", "rssi": -55, "showStyle": "拣货模板单列" }]

返回参数说明：

参数名称	示例值	类型	参数说明
lastOpreateTime	2022-03-24 04:53:15	String	最后操作（添加修改）时间
mac	99.89.40.57	String	标签id号
power	100	Integer	标签剩余电量
routerid	CWR000001	String	所属基站地址
rssi	-57	Integer	信号强度
showStyle	Picking Template	String	该标签屏幕显示的样式
		Text	暂无描述

三、仓储1代&11代&15代电子标签控制接口

接口地址：http://192.168.1.200/wms/associate/lightTagsLed (电池供电版本)

请求类型：application/json

请求方式：post

接口备注：仓储10代标签控制接口

调试工具：ApiPost

请求体参数说明：

参数名称	示例值	类型	参数说明
mac	99.89.40.57	string	标签设备ID号，示例：99.89.40.57
timeout	0	int	timeout=0，常亮，不会自动灭灯；timeout>0，(timeout)秒后标签自动熄灭；单位，秒；
lednum	255	int	单灯标签，默认传255多灯标签传灯的编号：1,2,3,4...
ledrgb	ffff00	string	红，ledrgb=“ff0000”;绿，ledrgb=”ff00”;蓝，ledrgb=“ff”；黄，ledrgb=“ffff00”;白，ledrgb=“ffffff”;不亮灯，ledrgb=“0”;
ledmode	0	int	固定：ledmode=0；常亮，不闪烁ledmode=3；灭灯ledmode=500, 500ms间隔闪烁；ledmode=1000, 1000ms间隔闪烁；......
reserve	reserve	string	reserve

请求示例：

[{"mac":"99.89.75.63","timeout":0,"lednum":255,"ledrgb":"ffff00","ledmode":0,"buzzer":1,"reserve":"reserve"}]

返回示例：

true

返回参数说明：

参数名称	示例值	类型	参数说明
无请求参数 KEY/VALUE 类型

四、仓储1代&11代标签按键回调

回调请求类型：application/json

回调请求方式：post

回调请求参数示例：

{"mac":"99.89.40.57", "result": 3}

回调请求参数说明：

参数名称	示例值	类型	参数说明
mac	99.89.40.57	string	触发按键的标签ID号
result	3	int	result:3，按键主动灭灯 result:4，超时自动灭灯

回调接口设置：

​

描述	url地址
pickButton	客户自己的回调接口地址

五、仓储10代电子标签控制接口

接口地址：http://192.168.1.200/wms/associate/lightTags

请求类型：application/json

请求方式：post

接口备注：仓储10代标签控制接口

调试工具：ApiPost

请求体参数说明：

参数名称	示例值	类型	参数说明
mac	99.89.40.57	string	标签设备ID号，示例：99.89.40.57
devtype	10	int	固定：devtype=10
timeout	0	int	timeout=0，常亮，不会自动灭灯；timeout>0，(timeout)秒后标签自动熄灭；单位，秒；
state	1	int	1，亮灯，亮数码管；0，灭灯，灭数码管；
ledrgb	ffff00	string	红，ledrgb=“ff0000”;绿，ledrgb=”ff00”;蓝，ledrgb=“ff”；黄，ledrgb=“ffff00”;白，ledrgb=“ffffff”;不亮灯，ledrgb=“0”;
ledcycle	0	int	固定：ledcycle=0；常亮，不闪烁ledcycle=500, 500ms间隔闪烁；ledcycle=1000, 1000ms间隔闪烁；......
quantity	999	int	电子标签显示的拣货数量,示例：5;数值大于999会显示：“FFF”

请求示例：

[{"mac":"99.89.40.57","devtype":10,"state":1,"timeout":0,"ledrgb":"ff00","ledcycle":0,"quantity": 999}]

返回示例：

true

返回参数说明：

参数名称	示例值	类型	参数说明
无请求参数 KEY/VALUE 类型

六、仓储10代标签按键回调

回调请求类型：application/json

回调请求方式：post

回调请求参数示例：

{"mac":"99.89.40.57", "result": 0}

回调请求参数说明：

参数名称	示例值	类型	参数说明
mac	99.89.40.57	string	触发按键的标签ID号
result	0	int	右下, result:0左上, result:1左中, result:2左下, result:3

回调接口设置：

​

编辑切换为居中

添加图片注释，不超过 140 字（可选）

描述	url地址
pickButton	客户自己的回调接口地址

七、巷道灯控制接口

接口地址：http://192.168.1.200/wms/associate/ctrlShelfIndicator

请求类型：application/json

请求方式：post

接口备注：仓储10代标签控制接口

调试工具：ApiPost

请求体参数说明：

参数名称	示例值	类型	参数说明
mac	99.88.40.20	string	标签设备ID号，示例：99.88.40.20
timeout	0	int	timeout=0，常亮，不会自动灭灯；timeout>0，(timeout)秒后标签自动熄灭；单位，秒；
ledrgb	ffff00	string	红，ledrgb=“ff0000”;绿，ledrgb=”ff00”;黄，ledrgb=“ffff00”;
ledmode	0	int	常亮快闪慢闪单个灭全灭
buzzer	1	int	0,蜂鸣器不响1.蜂鸣器响
reserve	reserve	string	reserve

请求示例：

[{"mac":"99.88.40.20","timeout":0,"ledrgb":"ffff00","ledmode":0,"buzzer":1,"reserve":"reserve"}]

返回示例：

true

返回参数说明：

参数名称	示例值	类型	参数说明
无请求参数 KEY/VALUE 类型

八、点亮结果回调

仓储1代，11代，巷道灯的点亮结果回调是同一个接口设置

回调请求类型：application/json

回调请求方式：post

回调请求参数示例：

{"mac":"99.89.40.57", "result": true}

回调请求参数说明：

参数名称	示例值	类型	参数说明
mac	99.89.40.57	string	触发按键的标签ID号
result	true	bool	true，点亮成功 false，点亮失败

回调接口设置：

​

描述	url地址
ctrlShelfIndicatorResult	客户自己的回调接口地址