公共技术规范

一、接口根域名

生产服：https://api.xianzhuanxia.com
测试服：https://cusapitest.xianzhuanxia.com

注意：测试服可能不稳定，但大部分时间都不影响使用。我们提供2个测试账号如下：

用户ID	key
558346	9a95033d04624caaa1c378bea2689346
558347	5e8a219173bf42ecb88906f080e5f5b0

二、请求接口方式

1：提交方式：https （get或post）
2：Content-Type：application/json;charset:utf-8;
3：响应参数的格式：body中获取，返回标准的json格式字符串数据。

三、异步通知方式

1：通知方式：http (post)
2：Content-Type：application/json;charset:utf-8;
3：通知参数的格式：body中获取，返回标准的json格式字符串数据。
4：每笔异步通知最多发起4次通知，依次间隔：第一次立即通知，第二次与第一次间隔2分钟通知，第三次与第二次间隔5分钟通知，第四次与第三次间隔10分钟通知。如果通知被正确响应，必须同步响应字符串小写英文字母 ok。闲赚侠收到ok后，将会停止后续的异步通知。如果4次异步通知都未正确响应通知结果，那么可以再商户端发起补发通知，也可自行查单。

四、签名规则

1：所有的主动请求闲赚侠的接口都需要在请求头中设置签名结果，请求头名称：Auth_Token。

💡

第一步：将请求参数不为空的值（特别注意double数字类型需要去除无效的小数点后面的0，比如12.00，需要转化成12），将请求参数按照首字母abcd.....顺序排序。依次拼接成待加密字符串格式，示例如下：key1=value1key2=value2key3=value3key4=value4......

第二步：在待加密原字符串数据末尾加上”queryTime=1687245817120key=签名密钥”。其中queryTime是当前系统毫秒数，每次请求都得使用最新的时间毫秒数。Key是签名密钥由闲赚侠提供。可以自行在闲赚侠个人中心API秘钥中查看。

第三步：将此原数据字符串进行md5加密后结果全部转小写。

第四步：编辑请求头中设置名称为：Auth_Token值的参数拼接：
【md5加密结果】拼接【英文逗号】拼接【用户编号】拼接【英文逗号】拼接【queryTime】
例如：de021b8728674841v0e960u2575fgt94,100001,1687245817120
然后将此值做base64加密。设置在Auth_Token请求头中。

注意：用户编号闲赚侠个人中心查看，queryTime是第二步中的当前系统毫秒数的值。

code	msg
0	成功，表示请求接口成功，已正常处理业务并且响应结果
1	技术性错误，出现此错误表示接口未对接通
100	商户不存在
101	商户未开通API权限或被禁用
103	产品维护
104	商户不满足产品的限定条件
105	查无此订单
106	订单状态不可更改
108	请求参数签名异常
200	账号被风控，msg会返回具体风控原因
201	请求频繁，请稍候再试
500	程序异常错误，出现此错误请查单处理

✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨✨

五、注意事项，对接开发前必读

所有提交订单的接口，如果出现响应超时，或者未响应任何结果，不能将订单做失败处理。必须隔3分钟之后，要通过闲赚侠提供的查询订单接口，去查询是否存在该提交的订单。

一、接口根域名#

二、请求接口方式#

三、异步通知方式#

四、签名规则#

五、注意事项，对接开发前必读#

一、接口根域名

二、请求接口方式

三、异步通知方式

四、签名规则

五、注意事项，对接开发前必读