请求结构 智能云相册的API服务接入地址见:服务地域
公共参数 公共请求参数是指每一个接口都需要使用到的参数:
名称 类型 必填项 描述 Format String 否 返回值的类型,支持JSON与XML,默认为XML。 Version String 是 API版本号,为日期形式:YYYY-MM-DD,本版本对应为2017-07-11。 AccessKeyId String 是 阿里云颁发给用户的访问服务所用的密钥ID,或者从您的业务服务器获取到的临时访问凭证中的临时密钥ID。 Signature String 是 签名结果串,关于签名的计算方法,请参见签名机制。 SignatureMethod String 是 签名方式,目前支持HMAC-SHA1。 Timestamp String 是 请求的时间戳。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ 例如,2014-7-29T12:00:00Z(为北京时间2014年7月29日的20点0分0秒。 SignatureVersion String 是 签名算法版本,目前版本是1.0。 SignatureNonce String 是 唯一随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。 SecurityToken String 是(特定情况) STS凭证,如果客户端从业务服务器获取STS凭证后访问智能云相册服务,该参数为必选。 LibraryId String 是(特定情况) 照片库的Id,如果使用AK认证的方式来对照片库进行操作,该参数为必选。如果使用STS认证的方式,LibraryId是通过SecurityToken中的RoleSessionName来进行传递,此时该参数为可选,如果提供了该参数,那么其值需要和RoleSessionName一致。
签名机制 智能云相册服务会对每个访问的请求进行身份验证,因此,需要在请求中包含签名(Signature)信息。智能云相册服务通过使用Access Key ID和Access Key Secret进行对称加密的方法来验证请求的发送者身份。Access Key ID和Access Key Secret由阿里云官方颁发给访问者(可以通过阿里云官方网站申请和管理),其中Access Key ID用于标识访问者身份;Access Key Secret是用于加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密,只有阿里云和用户知道。
返回结果 调用API服务后返回数据采用统一格式:
返回的HTTP状态码为2xx,代表调用成功; 返回4xx或5xx的HTTP状态码代表调用失败。 调用成功返回的数据格式主要有XML和JSON两种,外部系统可以在请求时传入参数来制定返回的数据格式,默认为XML格式。本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果是没有进行换行、缩进等处理的
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。