文档首页 > > API参考> 人脸识别API(V1)>

查询服务状态

查询服务状态

分享
更新时间:2021/04/19 GMT+08:00

功能介绍

用于查询服务的开通状态。

前提条件:

URI

GET /v1/{project_id}/subscribe

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,响应消息头中X-Subject-Token的值即为Token。

响应参数

状态码:200

表3 响应Body参数

参数名

参数类型

说明

max_face_set_number

Integer

调用成功时表示最大的人脸库数量。

调用失败时无此字段。

detect_service

Object

调用成功时表示该子服务信息,ServiceInfo结构详见ServiceInfo

调用失败时无此字段。

compare_service

Object

调用成功时表示该子服务信息,ServiceInfo结构详见表4

调用失败时无此字段。

live_detect_service

Object

调用成功时表示该子服务信息,ServiceInfo结构详见表4

调用失败时无此字段。

search_service

Object

调用成功时表示该子服务信息,ServiceInfo结构详见表4

调用失败时无此字段。

error_code

String

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

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

表4 ServiceInfo

参数

参数类型

描述

subscribe_status

Boolean

是否开通该子服务。

create_time

String

开通该子服务时间。

请求示例

X-Auth-Token值获取方法请参见认证鉴权

  • 请求样例
    GET https://{endpoint}/v1/{project_id}/subscribe
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...
  • Python3语言请求代码示例(其他语言参照下列示例编写或使用FRS SDK)
    # -*- coding:utf-8 -*-
    import requests
    
    endpoint = '开通服务所在region的人脸识别服务域名'
    project_id = '开通服务所在region的用户项目ID'
    token = '用户获取得到的实际token值'
    
    url = "https://{endpoint}/v1/{project_id}/subscribe".format(endpoint=endpoint, project_id=project_id)
    token = "用户获取得到的实际token值"
    headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
    
    response = requests.get(url, headers=headers, verify=False)
    print(response.text)

响应示例

状态码:200

成功响应示例
{
  "max_face_set_number": 10,
   "detect_service": {
        "subscribe_status": true,
        "create_time": "2018-09-03 08:16:48"
   },
   "compare_service": {
        "subscribe_status": true,
        "create_time": "2018-09-03 08:16:48"
   },
   "search_service": {
        "subscribe_status": true,
        "create_time": "2018-09-03 08:16:48"
   },
   "live_detect_service": {
        "subscribe_status": true,
        "create_time": "2018-09-03 08:16:48"
   }
}

状态码:400

失败响应样例
{
  "error_code": "FRS.0019",
  "error_msg": "The service has not been subscribed."
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

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

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问