阿里云首页 智能云相册

SearchPhotos

描述

搜索照片并分页返回结果

请求参数

参数名 类型 是否必须 说明
Action String SearchPhotos
Keyword String 搜索的关键字
Page Integer 指定服务端返回结果的页数
StoreName String PhotoStore的名称
Size Integer 指定服务端返回结果的每页记录条数。默认值为50,最大值为500。
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=SearchPhotos
  2. &Keyword=玩具
  3. &Page=1
  4. &Size=10
  5. &StoreName=cloudphoto-demo
  6. &LibraryId=alice-001
  7. &<公共请求参数>

返回参数

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

Photos

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

返回示例

JSON格式

  1. {
  2. "Photos":[
  3. {
  4. "IsVideo":false,
  5. "Md5":"6b680a5ec98537d18c87e9bb40fc0683",
  6. "Mtime":1499946529440,
  7. "State":"active",
  8. "Height":1200,
  9. "Id":822296943836270592,
  10. "Ctime":1499946529440,
  11. "Width":800,
  12. "Title":"demo-1.jpg",
  13. "FileId":"MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE"
  14. "TakenAt":1499946529440
  15. }
  16. ],
  17. "TotalCount":1,
  18. "Action":"SearchPhotos",
  19. "Message":"success",
  20. "RequestId":"12FFCB39-DCB4-4A9F-8C38-15AE9B759687",
  21. "Code":"Success"
  22. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <SearchPhotosResponse>
  3. <Photos>
  4. <Photo>
  5. <IsVideo>false</IsVideo>
  6. <Mtime>1499946529440</Mtime>
  7. <Md5>6b680a5ec98537d18c87e9bb40fc0683</Md5>
  8. <State>active</State>
  9. <Height>1200</Height>
  10. <Ctime>1499946529440</Ctime>
  11. <Id>822296943836270592</Id>
  12. <Width>800</Width>
  13. <FileId>MkM1N9sjSLe_LWWyxcA80wAAAApwZDIE</FileId>
  14. <Title>demo-1.jpg</Title>
  15. <TakenAt>1499946529440</TakenAt>
  16. </Photo>
  17. </Photos>
  18. <Action>SearchPhotos</Action>
  19. <TotalCount>1</TotalCount>
  20. <Message>success</Message>
  21. <RequestId>463B2C76-846D-4D1B-B741-428EE12B3287</RequestId>
  22. <Code>Success</Code>
  23. </SearchPhotosResponse>