最近更新时间:2021-10-19
视联云openAPI会对每个访问的请求进行身份验证,无论使用 HTTP 还是 HTTPS 协议提交请求,都需要在请求中包含签名信息。视联云openAPI通过使用 access key ID 和 access key secret 进行对称加密的方法来验证请求的发送者身份。
说明: 视联云openAPI会对每个访问的请求进行身份验证,无论使用 HTTP 还是 HTTPS 协议提交请求,都需要在请求中包含签名信息。STS 通过使用 access key ID 和 access key secret 进行对称加密的方法来验证请求的发送者身份。
使用请求参数构造规范化的请求字符串。
排序参数。
排序规则以首字母顺序排序,排序参数包括 公共参数和接口自定义参数。不包括公共请求参数中的Signature参数。
说明: 当使用 GET 方法提交请求时,这些参数就是请求 URL 中的参数部分,即 URL 中?
之后由&
连接的部分。
编码参数。
使用 UTF-8 字符集对每个请求参数的名称和参数取值进行 URL 编码,URL 编码规则如下:
对于字符 A-Z、a-z、0-9 以及字符-
、_
、.
、~
不编码;
对于其他字符编码成%XY
的格式,其中XY
是字符对应 ASCII 码的 16 进制。例如:半角双引号("
)对应的编码为:%22
。
空格( )需要被编码成:%20
,而不是+
。 说明: 一般支持 URL 编码的库都按照application/x-www-form-urlencoded
的 MIME 格式的规则进行编码,例如:Java 中的java.net.URLEncoder
。您可以直接使用这类方式进行编码,然后将编码后的字符串中加号+
替换成%20
、*
替换成%2A
、%7E
替换~
,即可得到上述规则描述的编码字符串。
使用=
连接编码后的参数名称和参数取值。
使用&
连接编码后的参数,得到规范化请求字符串。
说明: 参数排序需与排序参数保持一致。
使用规范化请求字符串构造用于计算签名的字符串,规则如下:
StringToSign= HTTPMethod + “&” + //发送请求的 HTTP 方法,例如 GET。percentEncode(“/”) + ”&” + //字符(/)UTF-8 编码得到的值,即 %2F。percentEncode(CanonicalizedQueryString)//规范化请求字符串
按照 RFC2104 的定义,计算签名 HMAC 值。
说明: 计算签名时使用的 key 就是用户持有的 access key secret 加上一个&
字符,其ASCII值为:38,使用的哈希算法是:SHA1。
按照Base64编码规则将 HMAC 值编码成字符串,得到签名值。
将签名值作为Signature
添加到请求参数中。
说明: 将签名值添加到请求参数时,需要按照 RFC3986 的规则进行 URL 编码。
见调用示例。