根据被访人编号查询人员信息

1. 应用场景

通过接口根据被访人编号（peopleNo）查询人员详细信息。

2. 请求链接

http://IP:Port/openapi/visitor/GetVisitorPeopel

3. 请求参数

字段 类型 长度 必填 描述 示例值
companyno string 32 是 企业编号 123456789
timestamp string 32 是 时间戳字符串 20200701161800123
sign string 50 是 签名字符串 规则参上
data string — 是 参数，必须是正确的 JSON 字符串格式并经过 AES 加密 详见参数示例
» peopleno String 50 是 被访人人员编号（Staff_No） S001

4. 返回结果

字段 类型 描述 示例值
resultcode string 结果状态 1 成功，0 失败
msg string 结果信息 获取成功
companyno string 企业编号 123456789
timestamp string 时间戳字符串 20200701161800123
sign string 签名字符串 规则参上
data string — 参数，必须是正确的 JSON 字符串格式并经过 AES 加密
» no string 人员编号
» jobNumber string 工号
» name string 姓名
» sex string 性别 男、女、未知
» phone string 手机号码
» idCard string 证件号
» icCard string IC卡号
» type string 名单类型 默认：白名单
» photo string 人员头像图片 阿里云在线url
» idCardPhoto string 证件照图片 阿里云在线url
» remark string 备注
» startDate string 开始有效期
» effDate string 结束有效期
» native string 籍贯
» nation string 民族
» residence string 户籍
» deptNo string 部门编号
» deptName string 部门名称
4.2 返回成功
{
    "resultcode": "1",
    "companyno": "1762766749844335",
    "timestamp": "20251120172204574",
    "data": "1jy8sFZ46tNBdn0O1NRSQ5ZYgTT9%2fMrVJ5LT1gYWB%2bw%3d",
    "msg": "{
              "jobNumber": "100676",
              "no": "1744965266261879",
              "name": "张*",
              "sex": "女",
              "phone": "18126179289",
              "idCard": "",
              "icCard": "1000000189",
              "type": "白名单",
              "photo": "",
              "idCardPhoto": "",
              "idCardPhoto1": null,
              "remark": "名单导入",
              "startDate": "2022-02-10 00:00:00",
              "effDate": "2052-02-10 23:59:59",
              "native": "",
              "nation": "",
              "residence": "",
              "deptNo": "1686638553482330",
              "deptName": "研发部"
            }",
    "sign": "e2b2f82eaa47c00edbf34b7691d8b678"
}
4.3 返回失败
{
  "resultcode": "0",
  "companyno": "1731746671916670",
  "timestamp": "20260815152031502",
  "data": "",
  "msg": "未找到该人员信息",
  "sign": "f124b39392389917baff9ed111fec5cd"
}
作者：潘诗标  创建时间：2026-08-15 12:03
最后编辑：潘诗标  更新时间：2026-08-15 15:23