提交/修改访客登记

1. 应用场景

通过接口提交/修改访客登记信息，完成访客信息录入。

2. 请求链接

http://服务器地址/api/v2/visitor/Create

3. 请求参数

字段 类型 长度 必填 描述 示例值
companyno string 32 是 企业编号 123456789
appid string 32 是 第三方应用appid 123456789
timestamp string 32 是 时间戳字符串 20200701161800123
sign string 50 是 签名字符串 规则参上
data string — 是 参数，必须是正确的 JSON 字符串格式并经过 AES 加密 详见参数示例
» no String 50 否 访客登记编号 修改时必填，提交新登记信息不要传该字段
» visitorname String 50 是 访客名称
» visitorphone String 50 是 手机号码
» photo String max 否 登记图片（base64或设备可访问的在线url地址） 完整base64内容或者完整url路径,软件在企业设置中，企业上传头像配置项后，照片为必填
» staffno String 50 是 被访人人员编号
» reason String 50 否 来访理由
» begintime String 50 是 访问开始时间 格式：yyyy-MM-dd HH:mm:ss
» endtime String 50 是 访问结束时间 格式：yyyy-MM-dd HH:mm:ss
» visitoridcard String 50 是 访客证件号
» carno String 50 否 车牌号

4. 返回结果

字段 类型 描述 示例值
resultcode string 结果状态 1 成功，0 失败
msg string 结果信息
companyno string 企业编号 e41e0f04d13e4196
timestamp string 时间戳字符串 20200701161800123
sign string 签名字符串 规则参上
data string — 是
» no String 访客登记编号 是
4.1. 返回成功
{
    "resultcode": "1",
    "companyno": "1762766749844335",
    "timestamp": "20251120172204574",
    "data": "1jy8sFZ46tNBdn0O1NRSQ5ZYgTT9%2fMrVJ5LT1gYWB%2bw%3d",
    "msg": "新增访客成功",
    "sign": "e2b2f82eaa47c00edbf34b7691d8b678"
}
4.2. 返回失败
{
    "resultcode": "0",
    "msg": "失败",
    "companyno": "2201140459374",
    "timestamp": "20220330142506052",
    "data": "",
    "sign": "7cc62da13e3c91bc8b7a07706d6a5243"
}
作者：张浩  创建时间：2026-10-29 15:57
最后编辑：张浩  更新时间：2026-10-29 16:13