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

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

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

阿里云服务器优惠

ListFaces

描述

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

请求参数

参数名	类型	是否必须	说明
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认证时可选。了解不同认证方式的区别。

请求示例

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

返回参数

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

Faces

参数名	类型	说明
Axis	数组	长度为4的数组，数组的元素为数字，前两个和后两个数字分别表示封面照片中的一个点的坐标。这两个点确定的矩形即为人脸在封面照片中的位置。比如，59，25，88，62，就表示人脸的左上角的坐标为（59，25），右下角的坐标为（88，62）。
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	人脸封面的照片Id，可以通过这个Id来获取照片的下载地址
Md5	String	人脸封面的Md5值。如果文件是以OSS分块上传方式上传的话，文件MD5为异步计算，在计算完成以前，MD5值为空。
Mtime	String	人脸封面的最后修改时间戳，单位：毫秒
State	String	文件的状态
Title	String	照片的名称
Width	Integer	照片的宽度

返回示例

JSON格式

{
    "TotalCount":8,
    "Action":"ListFaces",
    "Message":"success",
    "RequestId":"F6D18E5D-DD05-4063-8DFA-11F7903D410E",
    "Faces":[
        {
            "Name":"人脸ITTFZW",
            "IsMe":false,
            "Mtime":1500889601901,
            "Axis":[
                59,
                25,
                88,
                62
            ],
            "State":"active",
            "Id":824116397045981184,
            "Ctime":1500380320897,
            "Cover":{
                "Md5":"596cf2553f06ba5d2c249f206dc2f217",
                "Mtime":1500628851724,
                "State":"active",
                "Height":201,
                "Id":824117117514162176,
                "Ctime":1500380492669,
                "Width":300,
                "Title":"u=151615998,4109027133&fm=26&gp=0.jpg",
                "FileId":"3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE"
            },
            "PhotosCount":1
        }
    ],
    "NextCursor":"1500889601901:824116397045981184",
    "Code":"Success"
}

XML格式

<?xml version="1.0" encoding="UTF-8"?>
<ListFacesResponse>
  <Action>ListFaces</Action>
  <TotalCount>8</TotalCount>
  <Message>success</Message>
  <RequestId>AE1E3C70-FD84-4586-9E97-8DB7A5051808</RequestId>
  <Faces>
    <Face>
      <Name>人脸ITTFZW</Name>
      <IsMe>false</IsMe>
      <Axis>
        <Axis>59</Axis>
        <Axis>25</Axis>
        <Axis>88</Axis>
        <Axis>62</Axis>
      </Axis>
      <Mtime>1500889601901</Mtime>
      <State>active</State>
      <Cover>
        <Mtime>1500628851724</Mtime>
        <Md5>596cf2553f06ba5d2c249f206dc2f217</Md5>
        <State>active</State>
        <Height>201</Height>
        <Ctime>1500380492669</Ctime>
        <Id>824117117514162176</Id>
        <Width>300</Width>
        <FileId>3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE</FileId>
        <Title><![CDATA[u=151615998,4109027133&fm=26&gp=0.jpg]]></Title>
      </Cover>
      <Ctime>1500380320897</Ctime>
      <Id>824116397045981184</Id>
      <PhotosCount>1</PhotosCount>
    </Face>
  </Faces>
  <NextCursor>1500889601901:824116397045981184</NextCursor>
  <Code>Success</Code>
</ListFacesResponse>

版权声明

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

评论

-----