开发者社区> 问答> 正文

智能云相册API调用方式有哪些?

智能云相册API调用方式有哪些?

展开
收起
小天使爱美 2020-03-31 13:27:01 655 0
1 条回答
写回答
取消 提交回答
  • 请求结构 智能云相册的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格式。本文档中的返回示例为了便于用户查看,做了格式化处理,实际返回结果是没有进行换行、缩进等处理的

    2020-03-31 13:29:29
    赞同 展开评论 打赏
问答排行榜
最热
最新

相关电子书

更多
Spring Boot2.0实战Redis分布式缓存 立即下载
CUDA MATH API 立即下载
API PLAYBOOK 立即下载