仓储13代电子标签接口文档-V1.2

发布时间:2024年01月19日

电子标签标签注册

通过手动触发电子标签注册到系统,注册成功就可以进行功能测试。

仓储13代注册

用磁铁靠近标签右上角(灯珠上侧)

注册成功显示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)成功

{"datalist": [{"hardwareVersion": "4.5","height": 128,"mac": "99.26.17.85","manufacture": "CoreWind31","power": 100,"productionBatch": "20-08-29","routerId": 1,"rssi": -21,"screenType": 1,"serialNumber": "CNSHZH1000","shopNumber": "A0015","showStyle": "拣货模板单列","softwareVersion": "7.0","state": true,"status": 4,"tagRegisterEN": 1,"width": 296},{"hardwareVersion": "4.5","height": 128,"mac": "99.26.18.21","manufacture": "CoreWind31","power": 87,"productionBatch": "20-08-29","routerId": 1,"rssi": -19,"screenType": 1,"serialNumber": "CNSHZH1000","shopNumber": "A0015","showStyle": "拣货模板单列","softwareVersion": "7.0","state": true,"status": 4,"tagRegisterEN": 1,"width": 296},{"hardwareVersion": "4.5","height": 128,"mac": "99.26.18.36","manufacture": "CoreWind31","power": 100,"productionBatch": "20-08-29","routerId": 1,"rssi": -25,"screenType": 1,"serialNumber": "CNSHZH1000","shopNumber": "A0015","showStyle": "拣货模板单列","softwareVersion": "7.0","state": true,"status": 4,"tagRegisterEN": 0,"width": 296}],"resultCode": 10,"resultMsg": "success"}

返回参数说明:(201)失败

参数名

示例值

参数类型

参数描述

无请求参数 KEY/VALUE 类型

根据模板刷新屏幕接口

接口描述

墨水屏管理系统配置模板,然后根据设计的模板调用接口

接口信息

接口地址:

http://192.168.1.200/wms/associate/updateScreen

请求类型: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

自动显示可不传

请求示例:

[{"mac":"99.29.3.22","mappingtype":791,"styleid":44,"ledrgb":"0","ledstate":"0","outtime":"0""startMachine":"PE1-01","endMachine":"PE2-05","taskStartTime":"2022-11-18 9:00","basketsQuantity":"99","arrow":"","rssi":"","power":"",},{"mac":"99.29.3.22","mappingtype":791,"styleid":44,"ledrgb":"0","ledstate":"0","outtime":"0""startMachine":"PE1-01","endMachine":"PE2-05","taskStartTime":"2022-11-18 9:00","basketsQuantity":"99","arrow":"","rssi":"","power":"",}]

返回参数说明:(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

请求类型:application/json

请求方式:post

接口备注:暂无描述

调试工具:ApiPost

请求体参数说明:

参数名

示例值

参数类型

是否必填

参数描述

mac

99.26.17.85

string

指示灯所在标签的mac地址

lednum

694

int

只有一个灯默认传0或者255

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

预留

请求示例:

[{"mac": "99.88.64.65","lednum": 2,"timeout": 0,"ledrgb": "ff00","ledmode": 0,"reserve": "reserve","cmdtoken": "Inve123ntec"},{"mac": "99.88.64.65","lednum": 2,"timeout": 0,"ledrgb": "ff00","ledmode": 0,"reserve": "reserve","cmdtoken": "Inve123ntec"}]

返回参数说明:(200)成功

参数名

示例值

参数类型

参数描述

无请求参数 KEY/VALUE 类型

返回示例:(200)成功

true

返回参数说明:(201)失败

参数名

示例值

参数类型

参数描述

无请求参数 KEY/VALUE 类型

单独点灯接口结果回调

接口描述:

仓储13代电子标签点灯结果回调接口介绍;

接口信息

点灯结果回调接口

回调请求类型: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

数据成功;数据失败;数据发送超时;唤醒失败;基站不在线;数据异常;数据格式不正确,解析失败;参数格式不正确或参数不全,无法执行标签不存在;

回调接口设置

添加图片注释,不超过 140 字(可选)

描述

url地址

ctrlShelfIndicatorResult

客户自己的回调接口地址

按键事件回调

接口描述:

仓储13代电子标签按键事件回调接口介绍

接口信息

按键事件回调接口

回调请求类型:application/json

回调请求方式:post

回调参数格式:json object

回调请求备注:墨水服务器为调用方,客户软件接收回调

回调请求参数示例:

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

参数名称

示例值

类型

参数说明

mac

92.91.34.99

string

触发按键的标签ID号或者触发的RFID标签地址

result

0

int

按键:result=0,右下按键;读卡器:result=读卡器id; 读卡器后两位的int值,将入读卡器id是99.99.32.66Result=0x0242=578;

回调接口设置

`

添加图片注释,不超过 140 字(可选)

描述

url地址

enterKey

客户自己的回调接口地址

基站状态上报回调

接口描述:

基站状态上报回调接口介绍;

接口信息

基站状态上报回调接口

回调请求类型:application/json

回调请求方式:post

回调参数格式:json object

回调请求备注:墨水服务器为调用方,客户软件接收回调

回调请求参数示例:

{ "frequency": 460, //频率 "hardVersion": "8.1.2", //硬件版本 "id": 1844, //基站地址 "ip": "192.168.1.244", //IP地址 "longPeriod": 1, //长周期 "masterRouterMac": 0, "productBatch": "2021-11-01", "serialNumber": "CNSHZH1844", "shortPeriod": 0.5, //短周期 "softVersion": "8.3.3", //软件版本 "state": 1, // 1在线 , 0 离线 "tagRegisterEN": 1 //注册开关,1开启,0关闭}

请求体参数说明:

参数名

示例值

参数类型

是否必填

参数描述

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

客户自己的回调接口地址

标签注册事件回调

接口描述:

仓储13代电子标签注册事件回调接口介绍;

接口信息

按键事件回调接口

回调请求类型:application/json

回调请求方式:post

回调参数格式:json object

回调请求备注:墨水服务器为调用方,客户软件接收回调

回调请求参数示例:

{ "hardwareVersion": "4.7", //硬件版本 "height": 300, //高度 "mac": "99.88.29.86", //标签地址 "manufacture": "CoreWind24", "power": 100, //电量 "productionBatch": "20-11-05", "routerId": 1844, //基站地址 "rssi": -24, //信号强度 "screenType": 1, //屏幕类型 "serialNumber": "CNSHZH1000", "shopNumber": "A0001", "showStyle": "默认模板46", //样式名称 "softwareVersion": "7.2", //软件版本 "state": true, "status": 4, "tagRegisterEN": 1, //注册开关 "width": 400 //宽度}

请求体参数说明:

参数名

示例值

参数类型

是否必填

参数描述

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://blog.csdn.net/wxwt2003/article/details/135196284
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。