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

ListFacePhotos_人脸接口_API手册_智能云相册

admin 阿里云技术文档 2020-02-11 231 0

阿里云服务器优惠

ListFacePhotos

描述

分批列出包含该人脸的照片

请求参数

参数名	类型	是否必须	说明
Action	String	是	ListFacePhotos
FaceId	Long	是	指定人脸的ID
State	String	是	注意：State不是照片的状态，而是照片与人脸相簿关系的状态。可选值为active（表示照片属于人脸相簿中），removed（表示照片已从人脸相簿中移除）和all（表示所有状态）
StoreName	String	是	PhotoStore的名称
Cursor	String	否	指定拉取数据的游标。默认值为0，表示从最老的数据开始分批获取。
Direction	String	否	指定拉取数据的方向，可选值为backward和forward。forward表示获取比指定游标更新的数据，backward表示获取比指定游标更老的数据。默认值为forward
Size	Integer	否	指定服务端返回的最大记录条数，最大值为500。默认值为50。
LibraryId	String	否	照片库标识。采用AK认证时必选，采用STS认证时可选。了解不同认证方式的区别。

请求示例

https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListFacePhotos
&Cursor=0
&Direction=forward
&FaceId=824116397045981184
&Size=1
&State=active
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>

返回参数

参数名	类型	说明
RequestId	String	唯一标识本次请求的ID
Code	String	响应状态码，Success表示成功的响应
Message	String	响应状态详细描述
Action	String	ListFacePhotos
NextCursor	String	表示获取下一批数据的起始游标，如果为EOF则表示没有数据了。
Results	数组	详见结果信息
TotalCount	String	符合条件的记录总数

Results

参数名	类型	说明
PhotoId	Long	照片的唯一ID
State	String	照片与人脸的关系的状态

返回示例

JSON格式

{
    "TotalCount":1,
    "Action":"ListFacePhotos",
    "Message":"success",
    "RequestId":"C7535E87-F546-4DE1-A53F-266BC5E6E7EA",
    "NextCursor":"1500628852200:824117121146429440",
    "Results":[
        {
            "State":"active",
            "PhotoId":824117117514162176
        }
    ],
    "Code":"Success"
}

XML格式

<?xml version="1.0" encoding="UTF-8"?>
<ListFacePhotosResponse>
  <Action>ListFacePhotos</Action>
  <TotalCount>1</TotalCount>
  <Message>success</Message>
  <RequestId>D3BF1878-7759-4054-88BC-50876E5B20DA</RequestId>
  <NextCursor>1500628852200:824117121146429440</NextCursor>
  <Results>
    <Result>
      <State>active</State>
      <PhotoId>824117117514162176</PhotoId>
    </Result>
  </Results>
  <Code>Success</Code>
</ListFacePhotosResponse>

版权声明

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

评论

-----