协议规则

## 调用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秒以来的毫秒数