接口说明
公共参数
当虹云的API,除上传接口外,一般都会包含5个公用参数action,accessKey,version,timestamp 和 signature。
参数 | 描述 |
---|---|
action | API名称 |
accessKey | 分配给用户的accessKey |
version | API版本 |
timestamp | 时间戳(1970年1月1日以来的毫秒数,格林尼治时间) |
signature | 根据签名规则生成的签名串 |
生成签名
签名串通过以下规则和步骤生成:
- 对所有参数按照名称排序(CASE_INSENSITIVE_ORDER)生成一个字符串,并在字符串头上加上secretKey;
- 对该字符串调用HmacSHA256 算法生成signature;
- 每一个API,根据输入参数的不同,生成的签名都是不同的;
示例
我们以 获取帐户信息为例来说明签名的生成,该接口的参数为accessKey,action,version,timestamp,signature 5个: accessSecret = "5GcXHNYdAVVdFW0yervG"
accessKey = "a020e193-0f1"
action = "getUser"
version = "2.0"
timestamp= "1466488681033"
那么调用该接口的signature值就是:
signature = hmacSHA256Encrypt("5GcXHNYdAVVdFW0yervGaccessKey=a020e193-0f1action=getUsertimestamp=1466488681033version=2.0", "5GcXHNYdAVVdFW0yervG") = 3d864184117e240ad4def677c48fbba509a1d0d48ea5dfb9e914c587ae3ce5bf