CK_Label_V10 System Developer‘s Manual

CK_Label_V10 Registration

You should register the PTL to our Management System first;

Press the bottom-right and bottom-left buttton to trigger registration.

Register ok：The led turns from green to red in the up-right corner

Query PTL Tags Information

Introduction to the API：

Query all PTL tags information

Basic Information：

Attributes	接口信息
Status	Finished
URL	http://localhost/wms/associate/getTagsMsg
Request Method	GET/POST
Content-Type	multipart/form-data

Request parameters：

Parameter Description：

Attributes	Value	Required	Comment

Response parameters：

Attributes	Value	Types	Comment
lastOpreateTime	"2021-10-13 03:32:30"	string	Last opreate TIme
mac	"99.97.36.55"	string	Tag mac/Tag ID
power	100	string	Battery power(0~100)
routerid	CWR000001	string	ID of BindRouter
rssi	-26	int	Signal strength (-100 ~ 0)
showStyle	"Picking Template"	string	Using template name

Response example：

[{"lastOpreateTime": "2021-10-13 03:32:29","mac": "99.97.36.55","power": 100,"routerid": "CWR000001","rssi": -30,"showStyle": "Picking Template"},{"lastOpreateTime": "2021-10-13 03:32:30","mac": "99.97.36.53","power": 100,"routerid": "CWR000001","rssi": -26,"showStyle": "Picking Template"},{"lastOpreateTime": "2021-10-13 03:32:33","mac": "99.97.36.48","power": 88,"routerid": "CWR000001","rssi": -39,"showStyle": "Picking Template"}]

Callback of button event

Introduction to the API：

Notification of button event.

Basic Information：

Attributes	接口信息
Status	Finished
URL	URL of user's callback API
Request Method	POST
Content-Type	application/json

Request parameters：

Parameter Description：

Attributes	Types	Required	Comment
mac	string	yes	Tag mac / Tag ID
result	bool	Yes	result=0，right-lower button；result=1，left-top button；result=2，left-middle button；result=3，left-lower button；

Parameters example：

Json object

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

Light Leds of PTL(extern power supply)

Introduction to the API：

Query all PTL tags information

Basic Information：

Attributes	接口信息
Status	Finished
URL	http://localhost/wms/associate/lightTags
Request Method	POST
Content-Type	application/json

Request parameters：

Parameter Description：

Attributes	Types	Required	Comment
mac	string	Yes	Tag mac / Tag ID
devtype	int	Yes	Device type, devtype=10
timeout	int	Yes	Lighting timeout time(s);0 : never turn offn : turn off autoAutomatically after n seconds
state	int	Yes	1，led on，Digital Tube on；0，led off，Digital Tube off；
ledrgb	string	Yes	led color: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”
ledcycle	int	Yes	lightint mode;0, always on500, flash Interval 500ms1000, flash Interval 1000ms
quantity	int	Yes	Digital tube display, 0~999,If bigger than 999 will difplay “FFF”

Raw example：

[{"mac":"99.29.05.33","devtype":10,"displaytype":4,"timeout":0,"ledrgb":"ff00ff","ledcycle":0,"quantity":888},{"mac":"99.28.88.12","devtype":10,"displaytype":4,"timeout":0,"ledrgb":"ff00ff","ledcycle":0,"quantity":888}]

Response parameters：

Attributes	Value	Types	Comment

Response example：

true

Callback of Light Leds Result

Introduction to the API：

Notification the result of Light LedsBasic Information：

Attributes	接口信息
Status	Finished
URL	URL of user's callback API
Request Method	POST
Content-Type	application/json

Request parameters：

Parameter Description：

Attributes	Types	Required	Comment
mac	string	yes	Tag mac / Tag ID
power	int	yes	Battery power(0~100)
result	bool	Yes	true ：ok；false: failed；

Parameters example：

{"mac":"99.26.39.63","power":100,"result":true}

Light Roadway Lights

Introduction to the API：

Light Roadway Lights all PTL tags information

Basic Information：

Attributes	接口信息
Status	Finished
URL	http://localhost/wms/associate/ctrlShelfIndicator
Request Method	POST
Content-Type	application/json

Request parameters：

Parameter Description：

Attributes	Types	Required	Comment
mac	string	yes	Tag mac / Tag ID
timeout	int	yes	Lighting timeout time(s);0 : never turn offn : turn off autoAutomatically after n seconds
ledrgb	string	yes	red：ff0000; red Led Ongreen：ff00；green Led Onyellow：ffff00; yellow Led On
ledstate	int	Yes	lightint mode;0, always on1, quick flash2, slow flash
buzzer	int	yes	0：Buzzer off，1：Buzzer on
reserve	string	optional	reserve

Raw example：

[{"mac":"99.29.03.13","lednum":1,"timeout":0,"ledrgb":"ffff00","ledmode":0,"buzzer":0,"cmdtoken":"123456","reserve":"reserve"},{"mac":"99.29.05.33","lednum":1,"timeout":0,"ledrgb":"ff00ff","ledmode":0,"buzzer":0,"cmdtoken":"123456","reserve":"reserve"}]

Response example：

true

Callback of Light Roadway Lights Result

Introduction to the API：

Notification the result of Light Roadway Lights

Basic Information：

Attributes	接口信息
Status	Finished
URL	URL of user's callback API
Request Method	POST
Content-Type	application/json

Request parameters：

Parameter Description：

Attributes	Types	Required	Comment
mac	string	yes	Tag mac / Tag ID
result	bool	Yes	true ：ok；false: failed；

Parameters example：

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

Setting URL of user's callback API

Login wms system with admin user，go to “System Information”->“Third-party configuration”，you can config the Callback URL here:

反馈类型	描述	地址
Callback of UpdateScreen result	updateTagResult	URL of user's callback API
Callback of button event	enterKey	URL of user's callback API(CK_Label_V10, CK_Label_V3)
Callback of Light Leds Result	ctrlShelfIndicatorResult	URL of user's callback API