推特 阿里云技术文档正文

GetPhotos_照片接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 220 0
阿里云服务器优惠

GetPhotos

描述

批量获取特定Id的照片信息

请求参数

参数名 类型 是否必须 说明
Action String GetPhotos
PhotoId.1 Long 照片的唯一标识,如果有多张照片,请按照规则增加一个参数,比如2张照片,另外一个参数为PhotoId.2
StoreName String PhotoStore的名称
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=GetPhotos
  2. &PhotoId.1=859482159273005056
  3. &StoreName=cloudphoto-regression-store
  4. &<公共请求参数>

返回参数

参数名 类型 说明
RequestId String 唯一标识本次请求的ID
Code String 响应状态码,Success表示成功的响应
Message String 响应状态详细描述
Action String GetPhotos
Photos Photo[] Photo数组

Photos

参数名 类型 说明
Ctime String 创建的时间戳,单位:毫秒
FileId String 照片对应到存储在OSS上的文件名
Height Integer 照片的高度
Id Long 记录的唯一标识
InactiveTime Long 照片逻辑删除的时间戳,单位:毫秒
IsVideo Boolean 是否为视频,取值为true/false。
Md5 String 文件的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。
Mtime String 最后修改的时间戳,单位:毫秒
Remark String 备注
ShareExpireTime String 照片的分享过期时间,单位:毫秒
State String 照片的状态
TakenAt String 从照片的Exif读取到的照片拍摄时间,单位:毫秒
Title String 照片的名称
Width Integer 照片的宽度

返回示例

JSON格式

  1. {
  2. "Photos":[
  3. {
  4. "IsVideo":false,
  5. "Md5":"cbaa9d159391f659ad83f9c74d0fb107",
  6. "ShareExpireTime":0,
  7. "Height":300,
  8. "Title":"testimage2.jpg",
  9. "FileId":"M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE",
  10. "Mtime":1508812175585,
  11. "InactiveTime":0,
  12. "State":"active",
  13. "Id":859482159273005056,
  14. "Ctime":1508812175585,
  15. "Width":400,
  16. "TakenAt":0,
  17. "Remark":""
  18. }
  19. ],
  20. "Action":"GetPhotos",
  21. "Message":"success",
  22. "RequestId":"2C94E0B6-09FE-45FF-AC4E-D93989A120BD",
  23. "Code":"Success"
  24. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <GetPhotosResponse>
  3. <Photos>
  4. <Photo>
  5. <IsVideo>false</IsVideo>
  6. <Md5>cbaa9d159391f659ad83f9c74d0fb107</Md5>
  7. <ShareExpireTime>0</ShareExpireTime>
  8. <Height>300</Height>
  9. <Title>testimage2.jpg</Title>
  10. <FileId>M_BHZsehRWOm2UqDi77ZMAAAAC5wZDIE</FileId>
  11. <Mtime>1508812175585</Mtime>
  12. <InactiveTime>0</InactiveTime>
  13. <State>active</State>
  14. <Id>859482159273005056</Id>
  15. <Ctime>1508812175585</Ctime>
  16. <Width>400</Width>
  17. <Remark/>
  18. <TakenAt>0</TakenAt>
  19. </Photo>
  20. </Photos>
  21. <Action>GetPhotos</Action>
  22. <Message>success</Message>
  23. <RequestId>EA33B5A2-82FD-45C7-9290-6D21E7E31258</RequestId>
  24. <Code>Success</Code>
  25. </GetPhotosResponse>
版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。

评论

-----