初始化配置（新）

1、设备鉴权，连上MQTT后，会调用此初始化配置接口，并更新到本地
2、接口调用失败，则会使用本地数据

指令下发 ▼

订阅主题：/powerbank/{uuid}/user/get

数据格式：JSON字符串

名称	标识代码	数据类型	备注
指令名称	cmd	string	init

MQTT：更新初始化配置

{"cmd":"init"}

设备回复 △

无， 会触发API请求

API请求

请求URL

POST

https://{host}/api/rentbox/client/init?uuid={uuid}&sign={sign} 

Request URL: /api/rentbox/client/init
Content-Type: text/plain
sign=MD5("uuid={uuid}")

body

{
   "version": "20240904-RBMG-3.0.0.0",
   "manufacturer": "Welink",
   "model": "3568A",
   "radioVersion": "EC20CEHCLGR06A05M1G"
}

请求参数

名称	标识代码	是否必填	备注
服务器域名	host	YES	客户提供，例如：s.abc.com
设备全球唯一码	uuid	YES	4G通讯模块，IMEI号
接口签名	sign	YES	sign=MD5("uuid={uuid}")

Body

名称	标识代码	类型	备注
版本号	version	string	程序版本号
制造商	manufacturer	string	welink、BST
型号	model	string	-
通讯模块版本	radioVersion	string	-

请求示例

POST

https://s.abc.com/api/rentbox/client/int?uuid=860602069165357&sign=dfd1c44ce6c5a85d74627d8ffa6bff40

Request URL: /api/rentbox/client/init
Content-Type: text/plain
sign = MD5("uuid=860602069165357") = dfd1c44ce6c5a85d74627d8ffa6bff40

body

{
   "version": "20240904-RBMG-3.0.0.0",
   "manufacturer": "Welink",
   "model": "3568A",
   "radioVersion": "EC20CEHCLGR06A05M1G"
}

响应结果

名称	标识代码	类型	备注
状态码	code	int	默认：200
状态类型	type	int	默认：0
自定义数据	data	json	初始化参数
异常消息	msg	string	默认：OK
时间戳	time	long	当前毫秒时间戳

初始化参数

名称	标识代码	类型	备注
区域码	areaConfig	string	不同客户充电宝,不允许归还； 例如：0x00（通用）、0xAB（A客户）、0xCC(B客户）
防盗检测	antitheft	int	0：关闭 1：开启 场景：充电宝归还，堵侧边孔；0归还成功 1归还失败
归还锁充电宝	returnLocked	int	0：关闭 1开启 场景：归还失败；0弹出充电宝 1不弹出
最大充电仓位数	maxChargeSlots	int	0：关闭 范围：1~4; 备注：此功能与设备电源功率有关，仅支持部分机型，16仓以上机器不支持设置
调节音量	volume	int	0~100
调节背光	backlight	int	0~100
背光取反值	invertBacklight	int	0：关闭 1：开启 场景：部分厂商，0最大亮度 100最暗
Banner图片	banner	string[]	示例1： ["bottom", "https://abc.com/baaner.png"] 显示底部banner图片，尺寸1080*480像素 示例2： 空数组[]，不显示banner
二维码	qrcode	string[]	示例1：["100", "10107853", "20", "30", "https://s.weirink.com/sw/app/r/scan.html?id=10107853"] 100像素大小，机柜SN：10107853，相对banner坐标（20,30） 示例2： 空数组[]，不显示二维码

Banner图片

-	名称	标识代码	类型	备注
string[0]	位置	position	string	left | right | bottom | top
string[1]	图片路径	url	string	例如：https://abc.com/baaner.png

二维码

-	名称	标识代码	类型	备注
string[0]	二维码尺寸	size	string	100
string[1]	SN	sn	string	例如：10107853
string[2]	相对banner X坐标	x	string	0
string[3]	相对banner Y坐标	y	string	0
string[4]	二维码内容	content	string	https://s.weirink.com/sw/app/r/scan.html?id=10107853

{
    "code": 200,
    "type": 0,
    "data": {
        "areaConfig": "0x00",
        "antitheft": 0,
        "returnLocked": 0,
        "maxChargeSlots": 0,
        "volume": 80,
        "backlight": 80,
        "invertBacklight": 0,
        "banner": ["bottom", "https://abc.com/baaner.png"],
        "qrcode": ["100", "10107853", "20", "30", "https://s.weirink.com/sw/app/r/scan.html?id=10107853"]
    },
    "msg": "OK",
    "time": 1705661910697
}