# 检测多人作业（API名称：detect）
#### 功能介绍
在电网施工现场，要求必须多人配合作业。为提高安全管理水平，本产品对画面中的人员数量进行检测，并基于配置的最小人数决定是否告警，为需要多人协同作业的场景监管提供管理手段。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| 请求方式 | HTTPS地址                                          | 服务架构    | 消息体类型            |
|:---|:---|:---|:---|
| POST | https://***isdp+域名***/openapi/v1/aiObject/detect | OpenAPI | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| 参数           | 类型      | 是否必填 | 描述                |
|:---|:---|:---|:---|
| image_base64 | String  | 是    | 待识别的图片转成的base64串。 |
| object_list  | List    | 是    | 智能对象列表，以及智能对象的入参。 |
| max          | integer | 否    | 检测目标最大数量。         |
| min          | integer | 否    | 检测目标最小数量。         |
   
object_list说明：
| 参数        | 类型     | 是否必填 | 描述                                                                                   |
|:---|:---|:---|:---|
| object_id | string | 是    | 智能对象ID。详情请参见[智能对象标识]。 |
   
#### 响应参数
| 参数          | 类型     | 描述                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| result      | String | 响应结果。图片是否通过。 - Y：通过  - N：不通过   |
| object_list | Object | 响应数据。                                                                                                                                                                                                                                                                                                                                     |
   
object_list说明：
| 参数          | 类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| object_id   | String | 条目ID。                                                                                                                                                                                                                                                                                                                                                                                               |
| result      | String | 条目是否通过。 - Y：通过  - N：不通过   |
| num         | String | 检测到的目标数量。                                                                                                                                                                                                                                                                                                                                                                                           |
| remark_no   | String | 备注编号。                                                                                                                                                                                                                                                                                                                                                                                               |
| remark_en   | String | 评审通过/不通过时对应说明。                                                                                                                                                                                                                                                                                                                                                                                      |
| remark_cn   | String | 备注信息。                                                                                                                                                                                                                                                                                                                                                                                               |
| detect_list | List   | 条目检测结果信息。                                                                                                                                                                                                                                                                                                                                                                                           |
   
detect_list属性列表：
| 参数            | 类型     | 描述       |
|:---|:---|:---|
| similarity    | String | 置信度。     |
| lt_x          | String | 左上角点横坐标。 |
| lt_y          | String | 左上角点纵坐标。 |
| rb_x          | String | 右下角点横坐标。 |
| rb_y          | String | 右下角点纵坐标。 |
| category_name | String | 条目名称。    |
   
#### 请求示例
```
{"image_base64": str(b64),
       "object_list": [
               {"object_id": " ISDP_multiperson_operation",
                                           “max”: 10
                                           “min”: 2}
                    ]
            }
```
#### 响应示例
```
[{'result': 'Y',
  'object_list': [
      {'object_id': 'ISDP_multiperson_operation',
       'result': 'Y', 'num': None, 'remark_no': '',
       'remark_en': '[reason0]有2个人，在2-10000范围内。', 'remark_cn': '',
       'detect_list': [
           {'similarity': '0.9079309105873108', 'category_name': 'person', 'category_type': '', 'lt_x': '8.0', 'lt_y': '10.0', 'rb_x': '555.0', 'rb_y': '653.0'},
           {'similarity': '0.784828782081604', 'category_name': 'person', 'category_type': '', 'lt_x': '573.0', 'lt_y': '17.0', 'rb_x': '1103.0', 'rb_y': '651.0'}]
       }]}]
```
 #### 智能对象标识
| 智能对象ID                      | 描述   |
|:---|:---|
| Tesla_multiperson_operation | 多人作业 |