文档首页 > > API参考> 人脸识别API(V1)> 人脸资源管理> 查询人脸

查询人脸

分享
更新时间: 2019/11/08 GMT+08:00

功能介绍

查询指定人脸库中人脸信息。

URI

  • URI格式
    GET   /v1/{project_id}/face-sets/{face_set_name}/faces?offset=xxx&limit=xxx
    或者
    GET   /v1/{project_id}/face-sets/{face_set_name}/faces?face_id={face_id}
  • 参数说明

    参数名

    参数类型

    是否必选

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID/账号名/AK/SK

    face_set_name

    String

    人脸库名称。

    offset

    Integer

    与face_id二选一

    从第几条数据读起,默认为0。

    limit

    Integer

    与face_id二选一

    读取多少条,默认为5。

    face_id

    String

    与offset二选一

    人脸ID。

    offset+limit值不能超过10000。

请求消息

NA

响应消息

表1 响应参数

参数名

参数类型

说明

face_set_name

String

人脸库名称。

调用失败时无此字段。

face_set_id

String

人脸库ID,随机生成的包含八个字符的字符串。

调用失败时无此字段。

faces

List

返回的人脸信息,详见FaceSetFace

调用失败时无此字段。

error_code

String

调用失败时的错误码,具体请参考错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求样例
    Get https://{endpoint}/v1/{project_id}/face-sets/showFaceSet/faces?offset=0&limit=1
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
  • 响应样例
    {
      "face_set_id": "T785tx1N",
      "face_set_name": "showFaceSet",
      "faces": [
        {
          "bounding_box": {
            "width": 63,
            "top_left_y": 100,
            "top_left_x": 221,
            "height": 63
          },
          "external_image_id": "aIzRAa58",
          "face_id": "cFydu4d2",
          "external_fields": {
            "number": 122,
            "id": "home",
            "timestamp": 12
          }
        }
      ]
    }
  • 失败响应样例
    {
      "error_code": "FRS.0002",
      "error_msg": "The authentication token is abnormal."
    }

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区