接口描述:
- 获取设备收款所需参数,一般用于开机启动时,拉取配置参数,供后续接口调用
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 | 备注 |
---|
请求URL:
- 接口URL: /api/device/params
注:完整接口地址请联系技术咨询。
请求方式:
- POST
请求参数:
参数名 | 说明 |
---|---|
provider | 厂商标识,请与对接人获取 |
deviceId | 设备编号,设备的IMEI等,请确保唯一性 |
sign | 签名 |
返回数据说明:
参数名 | 说明 |
---|---|
appId | appId,作为设备后续接口参数 |
secretKey | secretKey,用于设备后续接口加签 |
url | 请求地址,作为设备后续接口的请求地址 |
sign | 签名 |
请求示例:
JSON请求参数:
{
"deviceId": "device1650010509",
"provider": "JEEPAY",
"sign": "50fb737fcfeb1fa52eacf4f72190a0cc"
}
URL请求参数:
请求地址 + ?provider=JEEPAY&deviceId=device1650010509&sign=50fb737fcfeb1fa52eacf4f72190a0cc
请求签名规则:
md5Key请与对接人获取
按照md5Key+deviceId+provider拼接,并转MD5后再转小写;拼接方式如:{md5Key}{deviceId}{provider}
签名例子:
假设MD5key:5c93bb17952842e1afde1ad5ff461b18
待加签字符串:5c93bb17952842e1afde1ad5ff461b18device1650010509JEEPAY
签名结果:50fb737fcfeb1fa52eacf4f72190a0cc
返回示例:
{
"code": 0,
"msg": "成功",
"data": {
"appId": "appId123",
"sign": "bb823aa25c808ffb933d9e3df707428d",
"secretKey": "appSecret123",
"url": "https://mch.s.jeepay.vip"
}
}
响应签名规则:
按照md5Key+appId+secretKey+url拼接,并转MD5后再转小写;拼接方式如:{md5Key}{appId}{secretKey}{url}
签名例子:
假设MD5key:5c93bb17952842e1afde1ad5ff461b18
待加签字符串:5c93bb17952842e1afde1ad5ff461b18appId123appSecret123https://mch.s.jeepay.vip
签名结果:bb823aa25c808ffb933d9e3df707428d
备注:
- 每次设备重启开机,调用该接口获取最新参数。获取到参数后,可保存在本地。
- 需设置请求超时时间为30s,当遇到请求异常、超时等情况,应继续使用本地已保存的参数。
文档更新时间: 2024-05-22 11:05 作者:朱小