帮我写人脸布控预警接口文档

接口名称：人脸布控预警接口

接口功能：对指定区域进行人脸识别，当系统检测到符合预设规则的人脸时，立即触发预警并将相关信息推送给相关人员。

请求URL：http://api.example.com/face-monitoring

请求方式：POST

请求参数：

| 参数名 | 类型 | 是否必填 | 描述 | | -------------- | ------ | -------- | ------------------------ | | access_token | string | 是 | 接口访问凭证 | | area_id | int | 是 | 监控区域id | | threshold | float | 否 | 人脸识别阈值 | | monitor_points | array | 是 | 监控点坐标数组 | | rule | object | 是 | 预设规则 | | callback_url | string | 是 | 预警信息回调接口地址 |

请求参数说明：

• access_token：接口访问凭证，用于验证接口访问权限。
• area_id：监控区域id，用于指定需要进行人脸监控的区域。
• threshold：人脸识别阈值，用于指定人脸识别的精度。
• monitor_points：监控点坐标数组，用于指定需要进行人脸监控的具体位置。
• rule：预设规则，用于指定人脸识别触发预警的条件。
• callback_url：预警信息回调接口地址，用于将预警信息推送给相关人员。

请求示例：

{ "access_token": "xxxxxxxxxxxx", "area_id": 111, "threshold": 0.8, "monitor_points": [ {"x": 10, "y": 10}, {"x": 20, "y": 20}, {"x": 30, "y": 30}, {"x": 40, "y": 40} ], "rule": { "age": {"min": 18, "max": 60}, "gender": "male", "expression": {"value": "smile", "threshold": 0.5} }, "callback_url": "http://example.com/callback" }

响应参数：

| 参数名 | 类型 | 描述 | | ------ | ------ | ---------- | | code | int | 响应状态码 | | msg | string | 响应信息 |

响应参数说明：

• code：响应状态码，用于表示接口请求是否成功。
• msg：响应信息，用于提示接口请求结果。

响应示例：

{ "code": 0, "msg": "请求成功" }