wms-3代货架标签（电池版本）接口文档
一、查询标签信息接口
接口类型：POST, 参数格式：json array
链接形式：
http://localhost/wms/associate/getTagsMsg
代码形式：
{
url : http://localhost/wms/associate/getTagsMsg,
requestMethed : GET,
requestParameter : {
} ,
response : {
[
{
"lastOpreateTime": "2020-09-23 03:39:06",
"mac": "99.97.44.47",
"power": 100,
"routerid": "CWR000001",
"rssi": -50,
"showStyle": "Pick Template"
},
{
"lastOpreateTime": "2020-09-23 03:39:08",
"mac": "99.97.44.60",
"power": 100,
"routerid": "CWR000001",
"rssi": -43,
"showStyle": "Pick Template"
}
]
}
请求参数介绍:
本地服务器用 localhost, 非本地则将 localhost 改为服务器所在主机 IP 地址
响应参数介绍: json array
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| lastOpreateTime |
string |
最后操作（添加修改）时间 |
最后操作（添加修改）时间 |
| mac |
string |
标签id |
标签id |
| power |
int |
电量 |
标签剩余电量 |
| routerid |
int |
所属基站Id |
所属基站id号 |
| rssi |
int |
信号强度 |
信号强度 |
| showStyle |
string |
显示样式 |
该标签屏幕显示的样式 |
二、更新墨水屏接口
接口类型：POST, 参数格式：json
http://localhost/wms/associate/updateScreen
代码形式：
{
url : http://localhost/wms/associate/updateScreen,
requestMethed : POST,
requestParameter:{
[
{
"mac":"99.99.8.56",
"mappingtype":694,
"styleid":30,
"ledstate":1,
"ledrgb":"ff00",
"outtime":0,
"料号":"abcdABCD-/*1234567891",
"版本号":"V12.27",
"CONFIG":"config",
"出库数量":"999999",
"入库数量":"999999",
"储位号":"A0-b2",
"库存数量":"999999"
},
{
"mac":"99.99.8.58",
"mappingtype":694,
"styleid":30,
"ledstate":1,
"ledrgb":"ff00",
"outtime":0,
"料号":"abcdABCD-/*1234567891",
"版本号":"V12.27",
"CONFIG":"config",
"出库数量":"999999",
"入库数量":"999999",
"储位号":"A0-b2",
"库存数量":"999999"
}
]
response:{
true
}
}
（此链接包含特殊字符”[” ”]”）请求参数介绍: json array
本地服务器用 localhost, 非本地则将 localhost 改为服务器所在主机 IP 地址
| 参数 |
类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
墨水屏ID |
需要更新的墨水屏ID号 |
| mappingtype |
in |
字段映射关系 |
字段映射关系类型，默认1 |
| styleid |
int |
模板样式ID |
选择不同的模板样式，默认1 |
| outtime |
int |
亮灯超时时间 |
Outtime（秒）之后标签led自动熄灭，outtime=0则不会自动熄灭 |
| ledstate |
int |
控制标签led状态 |
ledstate：0常亮, 每隔ledstate(ms)闪烁一次,ledstate=500及每隔500ms闪烁一次 |
| ledrgb |
string |
控制led灯的颜色 |
Led 颜色:红，ledrgb ="ff0000";绿，ledrgb="ff00";蓝，ledrgb="ff";浅蓝，ledrgb="ffff";黄，ledrgb="ffff00";白，ledrgb="ffffff";紫，ledrgb="ff00ff"; |
| 料号 |
string |
料号 |
参数名可以自定义 |
| 版本号 |
string |
版本号 |
参数名可以自定义 |
| CONFIG |
string |
CONFIG |
参数名可以自定义 |
| 出库数量 |
string |
出库数量 |
参数名可以自定义 |
| 入库数量 |
string |
入库数量 |
参数名可以自定义 |
| 储位号 |
string |
储位号 |
参数名可以自定义 |
| 库存数量 |
string |
库存数量 |
参数名可以自定义 |
注：显示参数可修改，多灯电子标签，该接口不支持亮灯，只会刷屏
三、墨水屏更新结果反馈
接口类型：POST, 参数格式：json object
代码形式：
{
requestMethed:POST,
requestParameter:{
{"mac":"99.99.08.51","power":100,"result":true}
},
response:{
}
}
响应参数介绍:
参数类型：json object
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
标签号 |
触发按键的标签ID号, 99.99.01.01 |
| power |
int |
墨水屏标签电量 |
更新数据库墨水屏电量, 100 |
| result |
bool |
墨水屏更新结果 |
墨水屏更新结果（bool）true ：更新成功；false：更新失败 |
四、拣货完成按标签确认键反馈接
接口类型：POST, 参数格式：json object
代码形式：
{
requestMethed:POST ,
requestParameter:
{
{"mac":"99.99.17.1","result":1}
},
response:{
}
}
参数格式：json object
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
标签号 |
触发按键的标签ID号 |
| result |
int |
按键反馈结果 |
result=0， 右1按键；result=1，左1按键；result=2，左2按键；result=3，左3按键； |
五、单个灯标签单独点灯控制接口
http://localhost/wms/associate/lightTagsLed
接口类型：POST, 参数格式：json array
代码形式：
{
url :http://localhost/wms/associate/lightTagsLed
requestMethed : POST,
requestParameter:{
[
{
"mac":"99.99.08.51",
"timeout":60,
"ledrgb":"ff00",
"ledmode":0,
"buzzer":1,
"reserve":"reserve"
},
{
"mac":"99.96.19.64",
"timeout":60,
"ledrgb":"ff00",
"ledmode":0,
"buzzer":1,
"reserve":"reserve"
}
]
response:{
true
}
}
（此链接包含特殊字符”[” ”]”）请求参数介绍:
本地服务器用 localhost, 非本地则将 localhost 改为服务器所在主机 IP 地址
请求参数介绍: json array
本地服务器用localhost, 非本地则将localhost改为服务器所在主机IP地址
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
要点亮标签ID |
标签设备ID号 |
| timeout |
int |
亮灯超时时间 |
对应时间多少秒后标签自动熄灭;0:一直亮，按键熄灭 |
| ledrgb |
string |
亮灯颜色 |
Led 颜色:红，ledrgb ="ff0000";绿，ledrgb="ff00";蓝，ledrgb="ff";浅蓝，ledrgb="ffff";黄，ledrgb="ffff00;白，ledrgb="ffffff";紫，ledrgb="ff00ff"; |
| ledmode |
int |
亮灯模式 |
0：常亮；1：快闪；2：慢闪；3灭灯 |
| buzzer |
int |
蜂鸣器状态 |
1：响，2：不响, |
| reserve |
string |
预留 |
预留 |
注：仓储三代无蜂鸣器，参数无效
响应参数介绍:
| 参数 |
功能 |
描述 |
|---|---|---|
| bool |
点亮数据发送指示 |
true：发送成功，false：发送失败 |
注：显示参数可修改
六、巷道灯控制
接口类型：POST, 参数格式：json array
http://localhost/wms/associate/ctrlShelfIndicator
代码形式：
{
url :http://localhost/wms/associate/ctrlShelfIndicator
requestMethed : POST,
requestParameter:{
[
{
"mac":"99.99.08.51",
"timeout":60,
"ledrgb":"ff00",
"ledmode":0,
"buzzer":1,
"reserve":"reserve"
},
{
"mac":"99.96.19.64",
"timeout":60,
"ledrgb":"ff00",
"ledmode":0,
"buzzer":1,
"reserve":"reserve"
}
]
response:{
true
}
}
（此链接包含特殊字符”[” ”]”）请求参数介绍:
本地服务器用 localhost, 非本地则将 localhost 改为服务器所在主机 IP 地址
请求参数介绍: json array
本地服务器用localhost, 非本地则将localhost改为服务器所在主机IP地址
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
要点亮标签ID |
标签设备ID号 |
| timeout |
int |
亮灯超时时间 |
对应时间多少秒后标签自动熄灭 |
| ledrgb |
string |
亮灯颜色 |
（异常报警）红：ff0000,（出库）绿：ff00；（入库）黄：ffff00, |
| ledmode |
int |
亮灯模式 |
0：常亮；1：快闪；2：慢闪；3灭灯 |
| buzzer |
int |
蜂鸣器状态 |
1：响，2：不响 |
| reserve |
预留 |
预留 |
响应参数介绍:
| 参数 |
功能 |
描述 |
|---|---|---|
| bool |
点亮数据发送指示 |
true：发送成功，false：发送失败 |
注：显示参数可修改
七、巷道灯结果反馈
接口类型：POST, 参数格式：json object
代码形式：
{
requestMethed:POST,
requestParameter:{
{"mac":"99.99.08.51","result":true}
},
response:{
}
}
响应参数介绍:
参数类型：json object
| 参数 |
数据类型 |
功能 |
描述 |
|---|---|---|---|
| mac |
string |
要点亮指示灯ID |
指示灯备ID号 |
| result |
bool |
反馈结果 |
true, 成功； false, 点亮失败 |
八、反馈回调地址设置
Admin用户登录到wms系统，进入“系统管理->第三方配置界面”，可以配置反馈接口的回调地址
| 反馈类型 |
描述 |
地址 |
|---|---|---|
| 墨水屏更新结果反馈 |
updateTagResult |
回调完整URL |
| 拣货完成确认键反馈(仓储3、10、23、24代) |
enterKey |
回调完整URL |
| 三色货架指示灯结果反馈/单独点灯结果反馈 |
ctrlShelfIndicatorResult |
回调完整URL |
| 按键反馈（仓储1代、11代） |
pickButton |
回调完整URL |
| 标签注册通知 |
tagRegisterAck |
回调完整URL |
| 基站状态通知 |
routerLoginAck |
回调完整URL |