# 检测指定时长或范围的智能对象（API名称：detect）
#### 功能介绍
标准智能对象检测服务，标准智能对象只判断目标有无，请求体中只需要传入图片的base64编码和object_id。
#### 相关接口
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取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    | 是    | 智能对象列表，以及智能对象的入参。 |
| startFlag    | integer | 否    | 是否从本张图片开始计时。      |
| min          | integer | 否    | 检测目标最小数量。         |
   
object_list说明：
| 参数              | 类型     | 是否必填 | 描述                                                                                   |
|:---|:---|:---|:---|
| object_id       | string | 是    | 智能对象ID。详情请参见[智能对象标识]。 |
| tenantId        | Long   | 否    | 租户ID。                                                                                |
| captureInterval | int    | 否    | 截帧频率（秒为单位）。                                                                          |
| deviceId        | String | 否    | 设备ID。                                                                                |
| alarmsBorder    | dict   | 否    | 边框坐标。                                                                                |
| alarmsDuration  | int    | 否    | 时长（分钟为单位）。                                                                           |
   
#### 响应参数
| 参数          | 类型     | 描述                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| 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),
  "startFlag": "false",
  "object_list": [  {"object_id": "Tesla_intrusion_detection", "tenantId": 152454541,
               "deviceId": "hbgygtyfybg", "alarmsDuration": 10, "captureInterval": 5,
               "alarmsBorder": {"p1": [10, 10], "p2":[10, 200], "p3":[200, 200], "p4":[200, 20]}}
]}}
```
#### 响应示例
```
[{'result': 'Y', 
  'object_list': [{'object_id': 'Tesla_intrusion_detection', 'result': 'Y', 'num': None, 'remark_no': '', 'remark_en': '[reason0]检测到人员入侵。', 'remark_cn': '', 'detect_list': [{'similarity': '0.5614089965820312', 'category_name': 'person', 'category_type': '', 'lt_x': '0.0', 'lt_y': '35.0', 'rb_x': '175.0', 'rb_y': '232.0'}]}]}]
```
 #### 智能对象标识
| 智能对象ID                        | 描述   |
|:---|:---|
| Tesla_personnel_sleeping_post | 人员睡岗 |
| Tesla_intrusion_detection     | 周界入侵 |
| Tesla_personnel_stay          | 人员滞留 |
| Tesla_personnel_off_post      | 人员离岗 |