公司写卡权限管理 - 授权证件接口设计

下载授权证件信息导入模板

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • form-data
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
返回:
返回示例
备注

返回 excel 文件

上传授权证件信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • excel 文件
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
fileurlFile加密狗数据 excel 文件
companyNamefileString厂商名称
cardNumberfileString证件号码
employeNamefileString号码对应员工姓名
expiringTimefileString失效时间 (yyyy-MM-dd HH🇲🇲ss)
返回:
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

1、根据公司名称获取公司的 id;
2、需要更新公司的所属证件数量;
3、失效时间不为空,解析为 date 类型

添加授权证件信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • excel 文件
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
companyNameurlString厂商名称
cardNumberurlString证件号码
employeNameurlString号码对应员工姓名
expiringTimeurlString失效时间 (yyyy-MM-dd HH🇲🇲ss)
返回:
参数名类型说明
codeInteger正确或者错误码
msgString正确或者错误提示
dataInteger返回数据

data 域包含数据:

参数名类型说明
idIntegerid
companyIdInteger公司 id
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

1、根据公司名称获取公司的 id;
2、需要更新公司的所属证件数量;
3、失效时间不为空,解析为 date 类型

查询授权证件列表信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • form-data
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
pageNumurlInteger当前页
pageSizeurlInteger每页数据条数
companyNameurlString厂商名称
cardNumberurlInteger证件号码
employeNameurlInteger号码对应员工姓名
statusurlString授权证件状态 0 停用,1 正常
返回:
参数名类型说明
codeInteger正确或者错误码
msgString正确或者错误提示
dataInteger返回数据

data 域包含数据:

参数名类型说明
totalLong总数据条数
rowsList数据行

rows 包含如下数据:

参数名类型说明
idIntegerid
companyNameString厂商名称
companyIdInteger厂商 id
cardNumberInteger证件号码
employeNameInteger号码对应员工姓名
expiringTimeInteger失效时间 (yyyy-MM-dd HH🇲🇲ss)
statusString授权证件状态 0 停用,1 正常
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

修改授权证件信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • form-data
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
idurlIntegerid
companyNameurlString厂商名称
companyIdurlInteger厂商 id
cardNumberurlString证件号码
employeNameurlString号码对应员工姓名
expiringTimeurlString失效时间 (yyyy-MM-dd HH🇲🇲ss)
statusurlString授权证件状态 0 停用,1 正常
返回:
参数名类型说明
codeInteger正确或者错误码
msgString正确或者错误提示
dataInteger返回数据
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

1、公司 id 不为空,根据公司 id 查询公司名称,校验传递的公司名称是否一致,不一致,获取公司 id,更新授权证件信息,获取不到公司 id,更新不成功;
2、公司变更,更新前后的公司授权证件数量重算;

删除授权证件信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • form-data
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
idurlIntegerid
返回:
参数名类型说明
codeInteger正确或者错误码
msgString正确或者错误提示
dataInteger返回数据
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

1、公司授权证件数量重算;

查询授权证件信息

请求 URL:
请求方式:
  • GET/POST
参数形式:
  • form-data
参数:
参数名位置类型说明是否必填
access_tokenheaderString用户 token
idurlIntegerid
返回:
参数名类型说明
codeInteger正确或者错误码
msgString正确或者错误提示
dataInteger返回数据

data 域包含数据:

参数名类型说明
idIntegerid
companyNameString厂商名称
companyIdInteger厂商 id
cardNumberInteger证件号码
employeNameInteger号码对应员工姓名
expiringTimeInteger失效时间 (yyyy-MM-dd HH🇲🇲ss)
statusString授权证件状态 0 停用,1 正常
返回示例
{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}
备注

上一篇 公司写卡权限管理 - 加密狗接口设计
公司写卡权限管理目录
下一篇 公司写卡权限管理 - 卡数据接口设计