接口调用
HTTP调用方式可以面向HTTP接口进行开发，ISV可以根据自己系统的情况，选择不同的实现语言来实现对接。
请求参数
- 公共请求头
除了HTTP协议中规定的头信息以外，本开放接口额外做以下头信息要求：
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| Content-Type | String | 请填写application/json;charset=UTF-8 |
| access_token | String | 大多数接口，需要通过验证身份以后才能访问，需要携带该头信息；请从OAuth接口获取的access_token |
| req_date | Long | 当前时间戳的毫秒数。可以参考java的System.currentTimeMillis()方法生成;（如果未携带该头信息，或与服务端的时间差超过 15 分钟，则云端拒绝该请求） |
| req_sign | String | 签名校验请求的合法性 |
- 公共返回报文
在所有请求的返回值里，有一些公共的字段：
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| code | String | 业务编码 |
| success | Boolean | 接口是否成功（是否发生业务异常） |
| reqId | String | 由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位 |
| message | String | 业务异常信息 |
| data | Oject | 业务数据 |
- 返回结果
请求成功时返回结果示例：
{
"reqId": "0550e35a24014277ab056cf7246eb7db",
"code": "2000",
"success": true,
"message": null,
"data": {
"access_token": ""
}
请求异常时返回示例：
{
"reqId": "8146864387cd4847801616abd9e2f16a",
"code": "2000",
"success": true,
"message": null,
"data": {
"error_msg": "应用的密钥无效!",
}
}
签名规则
每个请求头都需要添加req_sign字段，来验证请求的合法性，填写方法如下:
1、req_sign头信息填写的内容如下：
req_sign: API-SV1:<AppKey>:<Signature>
其中：
- API-SV1：表示签名算法版本，暂时固定API-SV1
- AppKey：为分配给接入方的AppKey
- Signature：为签名值，计算方法见下面描述
2、签名值的计算方法:
第一步，拼装待签名字符串
待签名字符串 = HTTPMethod + "_" + Content-Md5 + "_" + req_date + "_" + access_token + "_" + AppSecret
其中：
- HTTPMethod：为请求的方法，通常为POST
- Content-Md5：为请求Body内容的md5
- req_date：为请求头信息中的req_date
- access_token：为AppKey和AppSecret登录后获取
- AppSecret：为分配给接入方的密钥
注意：
签名字符串必须为UTF-8格式，含有中文字符的签名串必须先进行UTF-8编码
本文档中 md5 相关的结果都转为小写处理
第二步，计算签名
签名值 = Base64(MD5(待签名字符串)))
签名示例
| 签名示例 | 执行结果 | 示例描述 |
| 请求body： {"nsrsbh":"915211111111111111"} |
请求body Md5结果： Content-Md5=4e7f9b81e299ad014cfbc6949c3f4e04 |
请注意空格换行等空白字符，如果POST请求body内容包含空格换行等空白字符，请签名用的字符串也包含，保持和POST请求body一致，最简单的做法是请求body和计算签名都去掉空白字符串 |
| 待签名字符串： signStr=HTTPMethod_Content-Md5_req_date_accessToken_appSecret =POST_4e7f9b81e299ad014cfbc6949c3f4e04_xxx_yyy_zzz |
签名值过程
md5之后结果： e8e798e67dc2baa7b420169e08b135c4 再base64之后最终签名值： freq_signMD5=ZThlNzk4ZTY3ZGMyYmFhN2I0MjAxNjllMDhiMTM1YzQ= |
1、xxx请替换成实际的时间戳，类似1581588537349的格式 2、yyy请替换成实际取到的accessToken, 类似 eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJbLTEsLTEsLTEsMTAwLFwiXCIsMTAwMDEwMDEsbnVsbCxcIlwiLC0xXSIsImV4cCI6MTU4Mjg4Mjg0NSwiaWF0IjoxNTgxNTg2ODQ1fQ.T4GTFFzf6xD2n1rrCFVu88dQA8ipEobX2_i-Ub7qvIkxrTScmUm_113r1VEsTGhysA-jLFVwFWOtRqEaWvIvVA 3、zzz请替换成实际的appSecret，类似 9r27FCIHtmIAUBoNjA5Z5hq2vTCEfAL82YzrnV4vdlhpXAp2 |
| req_sign=API-SV1:appKey :freq_signMD5 | 最终请求header，req_sign的值： API-SV1:1000xxxx:ZThlNzk4ZTY3ZGMyYmFhN2I0MjAxNjllMDhiMTM1YzQ= |
1000xxxx请替换为实际的appkey |
- 上述举例的数据是为了验证签名算法，请先按照举例的数据验证 md5 和 base64 算法，看看生成的签名值是否正确，实际请求请按照实际数据签名。