查询白名单员工信息

接口功能

分页查询白名单员工信息。

请求地址

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

请求方式

POST，需要鉴权

请求参数

参数名称	参数类型	是否必需	参数含义	说明
storeIds	List<String>	否	不传默认查所有
queryKey	String	否	查询电话以及姓名
page	Integer	否	分页序号
pageSize	Integer	否	分页大小

请求示例

{
    "storeIds": ["store_001", "store_002"],
    "queryKey": "张三",
    "page": 1,
    "pageSize": 10
}

响应参数

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

data 数据模型

名称	参数	类型	说明
白名单 id	id	Integer
节点 id	storeId	String
节点名称	storeName	String
人员姓名	realName	String
电话号码	cellphone	String
描述	description	String
图片 id	pictureObjectId	String
图片地址	pictureUrl	String

响应示例

{
    "resultCode": "000000",
    "resultMsg": "成功",
    "data": [
        {
            "id": 1001,
            "storeId": "store_001",
            "storeName": "北京王府井店",
            "realName": "张三",
            "cellphone": "13800138000",
            "description": "新入职员工",
            "pictureObjectId": "obj_1234567890abcdef",
            "pictureUrl": "https://file-server.example.com/images/employee_1001.jpg"
        }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
}