调用API实现人脸检测

准备工作

注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。

步骤1：开通服务

1. 登录人脸识别服务控制台。

   控制台左上角默认显示服务部署在“华北-北京四”区域，请您根据业务需要选择对应区域，详细区域说明请参见什么是区域和可用区域。

2. 单击左侧“委托授权”，完成OBS授权。
   图1 服务授权
   
3. 选择需要使用的API，进行开通。

   本示例中需开通人脸检测API（V2）。

   图2 开通服务
   

步骤2：配置环境

1. 下载并安装Postman。

   Postman建议使用7.24.0版本。

2. 下载人脸识别服务Postman配置文件。

   下载地址：FRS-API.postman_collection.json。

3. 导入配置文件。
   1. 打开并登录Postman。
   2. 单击左上角“File > Import > Import File > Choose Files”导入配置文件。
      图3 导入配置文件
      

      配置文件导入成功后，将显示在Postman左侧导航栏中。

      图4 配置文件
      
      

      本配置文件中服务所属区域为“华北-北京四”，如果您在开通服务时，选择了其他区域，在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域，服务部署的区域具体请参见终端节点。

步骤3：Token认证鉴权

Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。

1. 在Postman左侧导航栏中单击“get-token”配置文件。
2. 单击“Body”配置项。填写用户名、密码、账号名。

   请登录“我的凭证”页面，复制IAM用户名、账号名至username、domainname参数处，并填写密码。

   

   

   获取Token时，如果出现The userInfo is wrong、APIGW.0101、The username or password is wrong报错，请参见如何处理账密报错。

   图5 Token认证鉴权
   
3. 单击“Send”，发送请求，获取并复制Token。

   获取返回结果“Headers”中的“X-Subject-Token”即为Token。

   关于token有效期的详细说明请参见获取IAM用户Token（使用密码）。

   图6 获取Token
   

步骤4：调用服务

人脸识别API的请求Body参数中输入数据支持图片的Base64编码、图片文件和图片URL路径，本示例中使用图片文件。

1. 在Postman左侧导航栏中单击“03 face-detect by file”配置文件。
2. 登录我的凭证，获取“华北-北京四”区域的项目ID，替换配置文件URL中的{{project_id}}。
3. 单击“Headers”配置项。将获取的Token复制到{{X-Subject-Token}}中。
   图7 修改配置文件
   
4. 单击“Body”配置项，上传需要进行人脸检测的图片。
   图8 修改配置文件
   
5. 单击“Send”，发送请求，获取调用结果。

   {
     "faces": [
       {
         "bounding_box": {
           "width": 174,
           "top_left_y": 37,
           "top_left_x": 22,
           "height": 174
         },
         "attributes": {
           "age": 35,
           "quality": {
              "total_score": 0.5869140625,
              "blur": 0.385498046875,
              "pose": 0.3349609375,
              "occlusion": 0.392333984375,
              "illumination": 0.3408203125
           },
            "expression": {
              "type": "happy",
              "probability": 0.74
           }
         }
       }
     ]
   }