查询访客登记列表

1. 应用场景

查询该企业的访客登记列表信息

2. 请求链接

http://IP:Port/openapi/visitor/GetVisitorRecordlist

3. 请求参数

字段	类型	长度	必填	描述	示例值
companyno	string	32	是	企业编号	123456789
timestamp	string	32	是	时间戳字符串	20200701161800123
sign	string	50	是	签名字符串	规则参上
data	string	—	是	参数，必须是正确的 JSON 字符串格式并经过 AES 加密	详见参数示例
» pageindex	Int	—	是	页码	1
» pagesize	Int	—	是	每页条数（建议 5~100）	20
» name	String	50	否	访客姓名（模糊匹配）	张三
» phone	String	50	否	访客手机号	13800000000
» idcard	String	50	否	访客身份证号	510000000000000000
» carno	String	50	否	车牌号（模糊匹配）	川A00000
» staffno	String	50	否	被访人人员编号（精确匹配）	S001
» peoplename	String	50	否	被访人姓名（模糊匹配）	李四
» begintime	String	50	否	来访开始时间（与 endtime 配对使用）	格式：yyyy-MM-dd HH:mm:ss
» endtime	String	50	否	来访结束时间（与 begintime 配对使用）	格式：yyyy-MM-dd HH:mm:ss

4. 返回结果

字段	类型	描述	示例值
resultcode	string	结果状态	1 成功，0 失败
msg	string	结果信息	获取成功
companyno	string	企业编号	123456789
timestamp	string	时间戳字符串	20200701161800123
sign	string	签名字符串	规则参上
data	string	—	参数，必须是正确的 JSON 字符串格式并经过 AES 加密
» total	Int	记录总数	100
» totalPage	Int	总页数	5
» data	Array	访客登记列表	见下方列表结构
»» no	String	访客登记编号	VR20250813001
»» name	String	访客姓名	张三
»» phone	String	访客手机号（明文）	13800000000
»» idcard	String	访客身份证号（明文）	510000000000000000
»» carno	String	车牌号	川A00000
»» begintime	String	来访开始时间	2025-08-13 09:00:00
»» endtime	String	来访结束时间	2025-08-13 18:00:00
»» addtime	String	登记时间	2025-08-13 08:30:00
»» peopleNo	String	被访人编号	S001
»» peopleName	String	被访人姓名	李四
»» companyName	String	企业名称	XX公司
»» departmentName	String	部门名称	技术部
»» status	String	访客状态	未审核/已拒绝/已审核/已到访/已签离
»» reason	String	来访原因	参观
»» remark	String	备注
»» checkTime	String	审核时间	2025-08-13 10:00:00
»» checkedOutTime	String	签离时间	2025-08-13 17:30:00
»» auditReason	String	拒绝原因

4.2 返回成功

{
    "resultcode": "1",
    "companyno": "1762766749844335",
    "timestamp": "20251120172204574",
    "data": "{
        "total": 56,
        "totalPage": 3,
        "data": [
            {
                "no": "VR20250813001",
                "name": "张三",
                "phone": "13800000000",
                "idcard": "510000000000000000",
                "carno": "川A00000",
                "begintime": "2025-08-13 09:00:00",
                "endtime": "2025-08-13 18:00:00",
                "addtime": "2025-08-13 08:30:00",
                "peopleNo": "S001",
                "peopleName": "李四",
                "companyName": "XX公司",
                "departmentName": "技术部",
                "status": "已审核",
                "reason": "参观",
                "remark": "",
                "checkTime": "2025-08-13 10:00:00",
                "checkedOutTime": "",
                "auditReason": ""
            }
        ]
    }",
    "msg": "获取成功",
    "sign": "e2b2f82eaa47c00edbf34b7691d8b678"
}

4.3 返回失败

{
    "resultcode": "0",
    "msg": "失败",
    "companyno": "2201140459374",
    "timestamp": "20220330142506052",
    "data": "",
    "sign": "7cc62da13e3c91bc8b7a07706d6a5243"
}

作者：潘诗标创建时间：2026-08-15 10:20
最后编辑：潘诗标更新时间：2026-08-15 15:23