检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。 200
如已开通服务,请检查开通服务的区域(或账号)与调用服务的区域(或账号)是否一致,若一致请检查API的URL是否拼写正确。 图2 检查区域信息 API Explorer界面调试时,请检查调用区域与开通服务区域是否一致。 图3 检查API Explorer区域信息 父主题: 错误码类
参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明 名称 类型 说明 action
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题: API
能超过10000。 face_id 否,与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统,暂时不支持数据遍历操作,用户可以自行保存face_id,根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数
数据安全类 使用FRS服务,是否会保存用户数据
活体检测 动作活体检测 静默活体检测 父主题: API
x。 face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题: 消息对象结构
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别,返回未经授权:The OBS is unauthorized时,您可以通过如下步骤处理: 使用OBS中的数据时,需要授权人脸识别服务能读取OBS数据,检查是否已在人脸识别服务的管理控制台单击过“委托授权”: 如果已经授权,界面将显示为“已授权”。
domainname:账号名 返回"error_code": "APIGW.0101" 请检查获取Token使用的url是否正确。以获取华北-北京四区域的token为例,采用post请求,url为: https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
调用API或SDK 在线调试 本地调用
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度,取值范围为0到1。置信度越高,表示系统越
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 使用external_image_id(人脸所在的外部图片ID)删除人脸库中的某一人脸特征 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces
子用户开通服务。 当*(Everyone)特殊用户开通后,其余子账户均可使用当前开通的子服务,不需要单独开通,子用户开通服务后,在调用人脸识别服务期间,调用节点需与开通服务节点保持一致。 子用户缺少某个特定权限 当创建的子用户缺少某个特定权限时,执行开通操作时,会报错误原因和缺少
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”,查看API的使用量。 父主题: API使用类