查询重点布控人员列表

接口功能

分页查询重点布控人员列表信息。

请求地址

https://open.qly.cmviot.cn/v3/open/api/ai/blacklist/page

请求方式

POST，需要鉴权

请求参数

参数名称	参数类型	是否必需	说明
storeId	String	否	节点 ID，仅支持叶子节点
page	Integer	否	分页序号
pageSize	Integer	否	分页大小

请求示例

{
    "storeId": "store_001",
    "page": 1,
    "pageSize": 10
}

响应参数

参数名称	参数类型	参数含义	说明
resultCode	String	响应码	参考响应码定义
resultMsg	String	响应描述
total	Integer	记录数	分页查询时使用
page	Integer	当前页	分页查询时使用
pageSize	Integer	页大小	分页查询时使用
data	List	响应数据	响应数据列表

BlacklistPerson 数据模型

名称	参数	类型	是否必需	说明
黑名单人员 id	blacklistPersonId	int	是
人员图片 url	personPictureUrl	string	是
布控节点集合	stores	Store[]	是
开始日期	startDate	string	否	格式：yyyy-MM-dd。包含该日期
结束日期	endDate	string	否	格式：yyyy-MM-dd。不包含该日期
描述	description	string	否	最长 50 个字符
创建时间	createTime	string	是	格式：yyyy-MM-dd HH:mm:ss

Store 数据模型

名称	参数	类型	是否必需	说明
节点 id	storeId	string	是
节点名称	storeName	string	是

响应示例

{
    "resultCode": "000000",
    "resultMsg": "成功",
    "data": [
        {
            "blacklistPersonId": 1001,
            "personPictureUrl": "https://file-server.example.com/images/blacklist_1001.jpg",
            "stores": [
                {
                    "storeId": "store_001",
                    "storeName": "北京王府井店"
                }
            ],
            "startDate": "2025-01-01",
            "endDate": "2025-12-31",
            "description": "重点监控人员",
            "createTime": "2025-01-01 10:00:00"
        }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
}