新增重点布控人员
接口功能
新增重点布控人员信息到黑名单。
请求地址
https://open.qly.cmviot.cn/v3/open/api/ai/blacklist/add请求方式
POST，需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 长度 | 说明 |
|---|---|---|---|---|
| 黑名单人员图片 | imageBase64 | 是 | 图片大小 2M，jpg,jpeg,png,bmp。如果大于 2M，返回超过大小，如果图片超大，超出网关要求，直接被网关拦截。图片 base64 编码后的字符串。注意：base64 编码不要携带 data:image/jpg;base64,这种形式的头 | |
| 节点 id | storeId | 是 | 30 | 必须为叶子节点，该节点上的设备抓拍到的人，会和该黑名单人员匹配（单节点）。单个店铺节点下最多只能添加 20 个黑名单人员 |
| 开始日期 | startDate | 否 | 时间格式：yyyy-MM-dd。包含该日期 。如果开始时间为空，数据库存入新建人员当日时间 | |
| 结束日期 | endDate | 否 | 时间格式：yyyy-MM-dd。包含该日期。如果开始时间为空，默认数据库存 NULL，表示永久有效 | |
| 描述 | description | 否 | 50 | 最长 50 个字符 |
请求示例
{
"imageBase64": "/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBAQE...",
"storeId": "store_001",
"startDate": "2025-01-01",
"endDate": "2025-12-31",
"description": "重点监控人员"
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| data | Object | 响应数据 | 响应数据 |
data 数据模型
| 名称 | 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|---|
| 黑名单人员 id | blacklistPersonId | int | 是 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功"
}