技术文档

访客门禁人员开门权限接口说明

2020-04-23

1接入方式

接入方式采用标准的http协议,参数区分大小写,采用RESTful风格。请求参数以JSON格式放入request body,均为键值对(key1=value1&key2=value2)的形式接收,所有字段都为文本字段,编码为UTF-8
注意:可以用jersey,RestEasy框架  ,不支持httpClient框架
 

1.1 人员权限添加方法PeopleDownLoad(POST)

URL= http://IP:Port/PeopleDownLoad?data={data}。
a、IP和Port为访客系统A014设置里面的IP地址和编号(如下图),在此要求IP地址为运行访客系统电脑的IP。
 
 
 
b、{data}为JSON格式的字符串,其字段如下表:
 

字段 类型 是否可置空 说明
devids String 要下发门禁板的ID,多个用逗号(,)隔开。
xm String 人员姓名
xb String   性别
dh String   电话
kh String IC卡号
sfzh String 身份证号
gw String   岗位
bm String   部门
fkrq DateTime 开门权限有效开始日期
yxrq DateTime 开门权限有效结束日期
yxcs Int 有效开门次数(65535不做次数限制)
qxlx Int 权限类型,0:IC卡;1:身份证; 

 
举例:
{
"devids":"69981278,33785612",
"xm":"张五",
"xb":"男",
"dh":"15920182858",
"kh":"38237623",
"sfzh":"440823198010253822",
"gw":"MCU工程师",
"bm":"研发部",
"fkrq":"2018-03-01",
"yxrq":"2099-12-31",
"yxcs":"65535",
"qxlx":"0"
}

1.2人员权限添加方法DeleteCard(POST)

URL= http://IP:Port/DeleteCard?data={data}。
使用方法请参考1.1人员权限添加方法PeopleDownLoad(POST)

1.3 PeopleDownLoad DeleteCard返回格式

按照统一格式返回,JSON格式:
{
    code: 0,//0成功,1失败
message: “请求成功!”, //描述说明
}

1.4获取门禁板列表方法QueryDevList(POST)

URL= http://IP:Port/QueryDevList 。
使用方法请参考1.1人员权限添加方法PeopleDownLoad(POST)
数据返回:
[{"DevId":"38829930","DevName":"host1"},{"DevId":"69981278","DevName":"host1"}]
DevId,门禁板ID;DevName,门禁板 名称。

1.5获取刷卡记录列表方法QueryReport(POST)

URL= http://IP:Port/ QueryReport?stime={stime}&etime={etime}
使用方法请参考1.1人员权限添加方法PeopleDownLoad(POST)
数据返回格式同1.4。
数据返回字段说明:

字段 类型 说明
Id String 自动ID
DevId String 门禁板ID
DevName String 门禁板名称
Port String 刷卡端口号(串口,韦根)
Dir String 开门方向
PostTime String 刷卡时间
CardState String 卡状态
CardType String 卡类型
ManName String 刷卡人姓名
Sex String 性别
Nation String 民族
Birth String 出生日期 
Addr String 地址
Card String 卡号
IssOrg String 签发机关
IssDate String 签发日期
ExpDate String 失效日期
QrCode String 二维码
Sec String 扇区内容
Dld String 刷卡网点
RecType String 记录类型(刷卡上报、S1反馈上报)
ManId String 关联的人员档案ID
ManType String 人员类型(访客,内部人员)
VisId String 关联的访客ID

关于我们

产品展示

15210326190

周一至周五 09:30~17:30