云相册的API人脸接口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>
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
相关问答
