设备鉴权

获取柜机的MQTT的地址、端口、账号密码。

API请求

请求URL

POST

https://{host}/api/rentbox/client/connect?simUUID={simUUID}&simMobile={simMobile}&uuid={uuid}&deviceId={deviceId}&sign={sign} 

/api/rentbox/client/connect

Content-Type:text/plain

请求参数

名称	标识代码	是否必填	备注
服务器域名	host	YES	客户提供，例如：s.abc.com
SIM卡唯一码	simUUID	NO	SIM卡ICCID
SIM卡手机号	simMobile	NO	SIM卡手机号
设备全球唯一码	uuid	YES	4G通讯模块的IMEI号
设备ID	deviceId	YES	预留参数，默认0
接口签名	sign	YES	MD5加密

Body

设备当前版本号

hardware=V6086&software=20240904-RBMG-3.0.0.0

接口签名

sign=MD5("deviceId={deviceId}|simMobile={simMobile}|simUUID={simUUID}|uuid={uuid}")

请求示例

POST

https://s.abc.com/api/rentbox/client/connect?simUUID=89860427092281034392&simMobile=&uuid=860602069165357&deviceId=0&sign=ff46bf468563a48b068d198158a21835

Content-Type:text/plain

Body

hardware=V6086

sign = ff46bf468563a48b068d198158a21835

MD5("deviceId=0|simMobile=|simUUID=89860427092281034392|uuid=860602069165357")

响应结果

{
    "code":200,
    "type":0,
    "data":"864601068367135,powerbank,212p044l42.zicp.fun,1883,864601068367135,e1fbe480cbb9fda953eb769a4200ea53,1705661910800",
    "msg":"OK",
    "time":1705661910697
}

名称	标识代码	类型	备注
状态码	code	int	默认：200
状态类型	type	int	默认：0
自定义数据	data	string	MQTT连接参数，","分割数组
异常消息	msg	string	默认：OK
时间戳	time	long	当前毫秒时间戳

MQTT连接参数

-	名称	标识代码	类型	备注
array[0]	唯一标识	clientId	string	例如：864601068367135 推荐：使用4G通讯模块的IMEI号
array[1]	产品名称	productKey	string	默认：powerbank
array[2]	连接地址	host	string	例如：212p044l42.zicp.fun
array[3]	端口号	port	int	默认：1883
array[4]	用户名	userName	string	例如：864601068367135
array[5]	密码	password	string	例如：e1fbe480cbb9fda953eb769a4200ea53
array[6]	时间戳	time	long	例如：1705661910800