文档中心 > 阿帕云 API> API> 公共接口参数
下载PDF

公共接口参数

最后更新时间: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&timestamp=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&timestamp=1572001628&version=v201903')