全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网

SearchPhotos

更新时间:2017-09-20 18:00:31

描述

搜索照片并分页返回结果

请求参数

参数名 类型 是否必须 说明
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>
本文导读目录