接口描述:

  • 获取设备收款所需参数,一般用于开机启动时,拉取配置参数,供后续接口调用

接口版本:

版本号 制定人 制定日期 修订日期 备注

请求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   作者:朱小