对接说明
配置租户
在后台【商户管理|商户】栏目配置/新增一个租户,假设绑定的域名为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×tamp=1234567890123&sign=abc123lang为返回错误信息时使用的语言。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时返回错误信息,成功时不返回",
}