› 推特 ›阿里云技术文档›正文

SearchPhotos_搜索接口_API手册_智能云相册

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

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>
版权声明

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

评论

-----