智能云相册中的公共请求参数类型

在阿里云的API调用中，公共请求参数是构成每一个API请求不可或缺的部分，它们确保了请求的安全性、版本控制以及格式规范等。您已经列举了一部分关键的公共请求参数及其说明，这里我将为您提供一个更清晰的总结和示例：

公共请求参数概览

1. Format:

   • 类型: String
   • 是否必填: 否
   • 描述: 指定返回值的格式，支持JSON与XML，默认为XML。

2. Version:

   • 类型: String
   • 是否必填: 是
   • 描述: API的版本号，格式为YYYY-MM-DD，例如2017-07-11。

3. AccessKeyId:

   • 类型: String
   • 是否必填: 是
   • 描述: 阿里云颁发给用户的访问服务密钥ID，或临时访问凭证中的临时密钥ID。

4. Signature:

   • 类型: String
   • 是否必填: 是
   • 描述: 签名结果字符串，用于验证请求的完整性和来源，计算方法遵循阿里云的签名机制。

5. SignatureMethod:

   • 类型: String
   • 是否必填: 是
   • 描述: 签名算法，目前只支持HMAC-SHA1。

6. Timestamp:

   • 类型: String
   • 是否必填: 是
   • 描述: 请求的时间戳，遵循ISO8601标准，使用UTC时间，如2014-7-29T12:00:00Z。

7. SignatureVersion:

   • 类型: String
   • 是否必填: 是
   • 描述: 签名算法版本，当前版本为1.0。

8. SignatureNonce:

   • 类型: String
   • 是否必填: 是
   • 描述: 用于防止重放攻击的随机字符串，每次请求应不同。

9. SecurityToken (特定情况):

   • 类型: String
   • 是否必填: 视情况而定（使用STS认证时）
   • 描述: STS凭证，当客户端通过STS方式获取权限时需要提供。

10. LibraryId (特定情况):

    • 类型: String
    • 是否必填: 视情况而定
    • 描述: 照片库的ID，根据认证方式（AK或STS）决定是否必须。

示例请求URL

基于上述参数，一个典型的API请求URL示例可能如下所示（注意替换<>内的内容为实际值）：

http://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListLibraries
&Format=json
&Version=2017-07-11
&AccessKeyId=<YourAccessKeyId>
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-04-01T12:00:00Z
&SignatureVersion=1.0
&Signature=<GeneratedSignature>
&SignatureNonce=<RandomNonce>

请注意，具体到每个API，还会有特定的Action和可能的其他业务参数需要添加到URL中。此外，生成Signature需要按照阿里云提供的签名算法进行计算，确保所有参数（包括非空的公共请求参数和业务参数）按规则排序并参与签名过程。