Skip to content

对接说明

配置租户

在后台【商户管理|商户】栏目配置/新增一个租户,假设绑定的域名为abc.com

配置密钥

在后台【商户管理|密钥】栏目配置密钥,假设密钥为secret123456

API调用

调用API时,使用POST请求,请求参数以JSON字符串发送,同时请求url中添加当前时时间戳及签名。如:

bash
curl -X POST \
    -H 'Content-Type: application/json' \
    -d '{"param1": "value1", "param2": "value2"}' \
    https://abc.com/api-path?lang=zh&timestamp=1234567890123&sign=abc123
  • lang为返回错误信息时使用的语言。
  • timestamp为当前时间戳,单位为毫秒,时间戳有效期为60秒
  • sign为签名,使用sha256算法生成。

签名生成算法

签名生成算法如下:

sign = sha256(body + timestamp + key)

如:

sign = sha256({"param1": "value1", "param2": "value2"}1234567890123secret123456)

返回结果

返回结果为JSON对象,如:

json
{
    "code": 0,
    "data": "code=0时返回处理结果,失败时不返回",
    "message": "code>0时返回错误信息,成功时不返回",
}