公共接口参数
最后更新时间:2022-12-09 09:25:22
说明
- 除了实名认证接口外,所有接口都使用该公共参数发起请求
- 请求URL:
https://api.apayun.com/gateway.do
- 请求方式:POST
提交参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
app_id | 否 | string | APP ID |
access_token | 是 | string | 认证Token,生成方式请参考 获取access_token 说明文档 |
sign_type | 是 | string | 签名方式 MD5或RSA2 |
sign | 是 | string | 签名字符串 |
method | 是 | string | 对应的方法 |
timestamp | 是 | int | 时间戳 (时间超时为5分钟,注:务必保证服务器和请求端的时间一致) |
version | 是 | string | 版本号 v201903 |
biz_content | 是 | string | 业务请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各接口文档 |
biz_content业务参数
具体参数可参考相关业务接口文档
业务参数数组 json化组成biz_content
签名方式
- md5签名生成方式
1.提交的参数按首字母排序后,并用&来拼接字符(不包括字节类型参数,如文件、字节流,剔除sign字段,剔除值为空的参数)
2.最后拼接&secret=API密钥
3.md5上面的字符串作为sign
4.示例:
sign = md5('access_token=1&app_id=2&biz_content={"mobile":"13400000000","real_name":"\u5f20\u4e09","id_card":"4450000000000000"}&method=333&sign_type=md5×tamp=1604028000&version=v201903&secret=CfKc7O8UPZZae5nuEhaBvVhNR3j73ZeG')
- RSA2签名过程
1.app创建时,服务器端需要保存应用的公钥(用来校验数据)
2.提交的参数按首字母排序后,并用&来拼接字符(不包括字节类型参数,如文件、字节流,剔除sign字段,剔除值为空的参数,)
3.RSA签名业务数据一下上面到字符作为sign
4.示例:
sign = md5('access_token=2&app_id=1&biz_content={"mobile":"13400000000","real_name":"\u5f20\u4e09","id_card":"4450000000000000"}&method=111&sign_type=MD5×tamp=1572001628&version=v201903')