协议规则
## 调用API必须遵循以下规则
|||
|-|-|
|传输方式|为保证安全性,采用HTTPS传输|
|提交方式|采用POST方法提交|
|数据格式|提交和返回数据都为JSON格式|
|字符编码|统一采用UTF-8字符编码|
|签名算法|MD5、SHA1、SHA256,后续会兼容HMAC等|
|签名要求|请求和接收数据均需要对核心参数进行校验签名,详细方法请参考[安全规范-签名算法]|
核心参数:
| 参数名 | 类型 | 必填 | 参与签名 | 说明 |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| appId | String | 是 | 是 | 平台分配给合作方的appid,联系平台商务获取 |
| nonceStr | String | 是 | 是 | 随机字符串,每次请求都不一样 |
| timestamp | String | 是 |是 | 时间戳(单位:毫秒值,如果是Unix timestamp需要✖️1000) |
| signType | String | 是 | 是 | 签名类型:MD5、SHA1、SHA256,后续会兼容HMAC等 |
| sign | String | 是 | 否 | 签名结果 |
>w 注意
◆ 接口参数不参与生成签名
◆ 需要将核心参数与接口参数一起传过来,如下
```
{
"appId":"",
"nonceStr":"",
"timestamp":"",
"signType":"",
"sign":"",
"param1":"接口参数1",
"param2":"接口参数2",
"param3":"接口参数3"
}
```
## 参数规范
- 时间:标准为北京时间,时区为东八区。格式为"yyyy-MM-dd HH:mm:ss"
- 时间戳:标准北京时间,时区为东八区,自1970年1月1日 0点0分0秒以来的毫秒数