# 2. 历史事件上报
**功能描述**
上报所有事件（数据库保存所有Event字段）给云平台。需要和监控服务器约定url，假设/EventServer/api/HistoryEvent
**调用URL**
调用方法: POST
**参数描述（JSON格式）：**
| | | | | | | |
| --------- | -------------- | ---------------- | ------ | ------ | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **index** | **一级参数** | **二级参数** | 类型 | **选择** | **说明** | 举例 |
| 1 | identity\_id | | string | **必选** | 用户编号 | "13435454" |
| 2 | identity\_name | | string | **必选** | 用户名称 | "Tom" |
| 3 | group\_name | | string | **必选** | 比对的group name，如果没有group\_name返回group\_id | "default\_group" |
| 4 | reg\_pic | | base64 | 可选 | 注册的人脸底库，可配置去除 | |
| 5 | timestamp | | int32 | **必选** | 事件发生的时间戳 | 1565771454932 |
| 6 | score | | float | **必选** | 比对的分数 | 0.23 |
| 7 | want\_action | | string | **必选** | 根据该字段判断需要进行的操作：
”0“：默认值， 不进行额外操作。
”1001“：新的陌生人注册。
”1002“：人脸注册底库更新。
| ”0“ |
| 8 | ext\_data | | dict | **必选** | 拓展数据字段，可迭代添加 | |
| | | device\_ip | string | **必选** | 设备ip | "192.168.1.101" |
| | | ep\_id | string | **必选** | 边缘节点ID，是指SE3 AI迷你机连接的采集设备的ID。
ID：dev\_sno和IP的组合，用双下划线做连接。举例：AKOPKKKKK\_\_192.168.1.25
| "3714be15-09b3-41ec-b9ce-62b668e5fa32\_\_192.168.1.101" |
| | | spot\_pic | base64 | 可选 | 现场照片 | |
| | | recognize\_face | base64 | 可选 | 背景图中的每张人脸图 | |
| | | person\_type | int | **必选** | 1:员工（默认为员工，包括这个字段不存在的情况）
2: 访客
3: 黑名单
4：陌生人
5：VIP
| 1 |
| | | device\_type | string | **必选** | 0：闸机，
1：抓拍机
3：IPC 动态
4：门禁
| 0 |
| | | grab\_fiqa\_info | dict | **必选** | 其他设备模式内容为空（抓拍机模式下只有臻识抓拍机有效），返回抓拍机得人脸质量检测结果，详细请看示例 | {} |
| | | box\_fiqa\_info | dict | **必选** | 其他设备模式内容为空(抓拍机模式有值)，返回AI BOX得人脸质量检测结果，详细请看示例 | {} |
| | | dev\_sno | string | **必选** | SE3 AI迷你机唯一标识授权码 | |
**返回信息：**
```json
{
'score': 0.16,
'reg_pic': 'xxx',
'group_name': 'default_group',
'identity_id': '13028',
'identity_name': 'stranger',
"want_action":"0",
'timestamp': 1560408984678,
'ext_data': {
'device_type': '1',
'grab_fiqa_info': { //臻识抓拍机返回的信息
'confidence': 90,
'face_id': 1381,
'rect': {'top': 420, 'bottom': 524, 'right': 1734, 'left': 1652},
'pitch': 0,
'age': 4,
'rel_rect': {'top': 62, 'bottom': 166, 'right': 134, 'left': 52},
'yaw': 0,
'eye_dist': 82,
'roll': 0,
'sex': 1}, //性别0为男， 1为女
'spot_pic': 'xxxxx',
'recognize_face':"xxx",
'box_fiqa_info': { //AI BOX端返回的图片质量检测信息
'age':4,
'sex':1, //性别0为男，1为女
'info': {'face_size': 255.0,
'clarity': 1.285613331998212,
'headpose': {'roll_angle': 10.107, 'pitch_angle': 14.413, 'yaw_angle': 7.326},
'partial': False,
'brightness': 0.8362176798557405}, //图片质量检测的参数
'fiqa_result': True, //fiqa是否合格的标志，True表示图片质量比较好
'success': ['face_size', 'clarity', 'headpose', 'partial', 'brightness'],
'fails': []},
'person_type': 1, //通过此处的人员类型来判断是否是陌生人，如果是person_type为4， 则是陌生人，且fiqa_result为False，则说明陌生人的图片质量不是很好，不能进行再次下发注册
'device_ip': '192.168.1.151'}
}
```
**示例：**
可以使用小盒子附带的server来获取上传的事件。
假设小盒子的ip为：192.168.1.19，接收的resetful api为HistoryEvent ，端口号为9528。
那webui或是配置/修改历史事件上报接收服务器地址信息为：[http://192.168.1.19:9528/HistoryEvent](http://192.168.1.19:9528/RealTimeEvent)
启动server方法：
```shell
$ sudo -i
\# cd /system/data/sophon_gate/script
\# python3 Event_Receive_server.py
* Serving Flask app "Event_Receive_server" (lazy loading)
* Environment: production
WARNING: Do not use the development server in a production environment.
Use a production WSGI server instead.
* Debug mode: off
* Running on http://0.0.0.0:9528/ (Press CTRL+C to quit)
```