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

ListFaces

更新时间:2017-09-20 17:57:32

描述

分批列出当前用户照片中包含的人脸

请求参数

参数名 类型 是否必须 说明
Action String ListFaces
State String 指定人脸的状态,服务端只返回指定状态的人脸。可选值有active, inactive, deleted, all。关于人脸状态的变化请参考:数据模型
StoreName String PhotoStore的名称
Cursor String 指定拉取数据的游标。默认值为0,表示从最老的数据开始分批获取。
Direction String 指定拉取数据的方向,可选值为backward和forward。forward表示获取比指定游标更新的数据,backward表示获取比指定游标更老的数据。默认值为forward
Size Integer 指定服务端返回的最大记录条数,最大值为500。默认值为50。
LibraryId String 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。

请求示例

  1. https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListFaces
  2. &Cursor=0
  3. &Direction=forward
  4. &Size=1
  5. &State=active
  6. &StoreName=cloudphoto-demo
  7. &LibraryId=alice-001
  8. &<公共请求参数>

返回参数

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

Faces

参数名 类型 说明
Axis 数组 长度为4的数组,数组的元素为数字,前两个和后两个数字分别表示封面照片中的一个点的坐标。这两个点确定的矩形即为人脸在封面照片中的位置。
Cover Object 人脸的封面照片
Ctime String 创建的时间戳,单位:毫秒
Id Long 记录的唯一标识
IsMe Boolean 人脸是否为用户自己
Mtime String 最后修改的时间戳,单位:毫秒
Name String 人脸的名称,为命名的为空字符串
PhotosCount String 包含有该人脸的照片总数
State String 人脸的状态

Cover

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

返回示例

JSON格式

  1. {
  2. "TotalCount":8,
  3. "Action":"ListFaces",
  4. "Message":"success",
  5. "RequestId":"F6D18E5D-DD05-4063-8DFA-11F7903D410E",
  6. "Faces":[
  7. {
  8. "Name":"人脸ITTFZW",
  9. "IsMe":false,
  10. "Mtime":1500889601901,
  11. "Axis":[
  12. 59,
  13. 25,
  14. 88,
  15. 62
  16. ],
  17. "State":"active",
  18. "Id":824116397045981184,
  19. "Ctime":1500380320897,
  20. "Cover":{
  21. "Md5":"596cf2553f06ba5d2c249f206dc2f217",
  22. "Mtime":1500628851724,
  23. "State":"active",
  24. "Height":201,
  25. "Id":824117117514162176,
  26. "Ctime":1500380492669,
  27. "Width":300,
  28. "Title":"u=151615998,4109027133&fm=26&gp=0.jpg",
  29. "FileId":"3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE"
  30. },
  31. "PhotosCount":1
  32. }
  33. ],
  34. "NextCursor":"1500889601901:824116397045981184",
  35. "Code":"Success"
  36. }

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <ListFacesResponse>
  3. <Action>ListFaces</Action>
  4. <TotalCount>8</TotalCount>
  5. <Message>success</Message>
  6. <RequestId>AE1E3C70-FD84-4586-9E97-8DB7A5051808</RequestId>
  7. <Faces>
  8. <Face>
  9. <Name>人脸ITTFZW</Name>
  10. <IsMe>false</IsMe>
  11. <Axis>
  12. <Axis>59</Axis>
  13. <Axis>25</Axis>
  14. <Axis>88</Axis>
  15. <Axis>62</Axis>
  16. </Axis>
  17. <Mtime>1500889601901</Mtime>
  18. <State>active</State>
  19. <Cover>
  20. <Mtime>1500628851724</Mtime>
  21. <Md5>596cf2553f06ba5d2c249f206dc2f217</Md5>
  22. <State>active</State>
  23. <Height>201</Height>
  24. <Ctime>1500380492669</Ctime>
  25. <Id>824117117514162176</Id>
  26. <Width>300</Width>
  27. <FileId>3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE</FileId>
  28. <Title><![CDATA[u=151615998,4109027133&fm=26&gp=0.jpg]]></Title>
  29. </Cover>
  30. <Ctime>1500380320897</Ctime>
  31. <Id>824116397045981184</Id>
  32. <PhotosCount>1</PhotosCount>
  33. </Face>
  34. </Faces>
  35. <NextCursor>1500889601901:824116397045981184</NextCursor>
  36. <Code>Success</Code>
  37. </ListFacesResponse>
本文导读目录