"下载授权证件信息导入模板请求 URL： [链接] 请求方式： GET/POST 参数形式： form-data 参数：参数名位置类型说明是否必填 access_tokenheaderString用户 token是返回：返回示例备注返回 excel 文件上传授权证件信息请求 U ...."

qiankunpingtai
荆棘从死亡中来，死亡又包含着新生。
接口 • 0 回帖 • 1.2K 浏览 • 4 年前

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

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

请求 URL：

http://ip:port/identityCard/downloadIdentityCardTemplate

请求方式：

GET/POST

参数形式：

form-data

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是

返回示例

备注

返回 excel 文件

上传授权证件信息

请求 URL：

http://ip:port/identityCard/importIdentityCardData

请求方式：

GET/POST

参数形式：

excel 文件

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
file	url	File	加密狗数据 excel 文件	是
companyName	file	String	厂商名称	是
cardNumber	file	String	证件号码	是
employeName	file	String	号码对应员工姓名	是
expiringTime	file	String	失效时间 (yyyy-MM-dd HH🇲🇲ss)	否

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

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

添加授权证件信息

请求 URL：

http://ip:port/identityCard/addIdentityCardInfo

请求方式：

GET/POST

参数形式：

excel 文件

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
companyName	url	String	厂商名称	是
cardNumber	url	String	证件号码	是
employeName	url	String	号码对应员工姓名	是
expiringTime	url	String	失效时间 (yyyy-MM-dd HH🇲🇲ss)	否

参数名	类型	说明
code	Integer	正确或者错误码
msg	String	正确或者错误提示
data	Integer	返回数据

data 域包含数据：

参数名	类型	说明
id	Integer	id
companyId	Integer	公司 id

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

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

查询授权证件列表信息

请求 URL：

http://ip:port/identityCard/queryIdentityCardList

请求方式：

GET/POST

参数形式：

form-data

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
pageNum	url	Integer	当前页	是
pageSize	url	Integer	每页数据条数	是
companyName	url	String	厂商名称	否
cardNumber	url	Integer	证件号码	否
employeName	url	Integer	号码对应员工姓名	否
status	url	String	授权证件状态 0 停用，1 正常	否

参数名	类型	说明
code	Integer	正确或者错误码
msg	String	正确或者错误提示
data	Integer	返回数据

data 域包含数据：

参数名	类型	说明
total	Long	总数据条数
rows	List	数据行

rows 包含如下数据：

参数名	类型	说明
id	Integer	id
companyName	String	厂商名称
companyId	Integer	厂商 id
cardNumber	Integer	证件号码
employeName	Integer	号码对应员工姓名
expiringTime	Integer	失效时间 (yyyy-MM-dd HH🇲🇲ss)
status	String	授权证件状态 0 停用，1 正常

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

修改授权证件信息

请求 URL：

http://ip:port/identityCard/updateIdentityCardInfo

请求方式：

GET/POST

参数形式：

form-data

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
id	url	Integer	id	是
companyName	url	String	厂商名称	是
companyId	url	Integer	厂商 id	是
cardNumber	url	String	证件号码	是
employeName	url	String	号码对应员工姓名	是
expiringTime	url	String	失效时间 (yyyy-MM-dd HH🇲🇲ss)	否
status	url	String	授权证件状态 0 停用，1 正常	否

参数名	类型	说明
code	Integer	正确或者错误码
msg	String	正确或者错误提示
data	Integer	返回数据

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

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

删除授权证件信息

请求 URL：

http://ip:port/identityCard/deleteIdentityCardById

请求方式：

GET/POST

参数形式：

form-data

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
id	url	Integer	id	是

参数名	类型	说明
code	Integer	正确或者错误码
msg	String	正确或者错误提示
data	Integer	返回数据

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

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

查询授权证件信息

请求 URL：

http://ip:port/softdog/getIdentityCardById

请求方式：

GET/POST

参数形式：

form-data

参数：

参数名	位置	类型	说明	是否必填
access_token	header	String	用户 token	是
id	url	Integer	id	是

参数名	类型	说明
code	Integer	正确或者错误码
msg	String	正确或者错误提示
data	Integer	返回数据

data 域包含数据：

参数名	类型	说明
id	Integer	id
companyName	String	厂商名称
companyId	Integer	厂商 id
cardNumber	Integer	证件号码
employeName	Integer	号码对应员工姓名
expiringTime	Integer	失效时间 (yyyy-MM-dd HH🇲🇲ss)
status	String	授权证件状态 0 停用，1 正常

返回示例

{
  "code": 200,
  "msg": "操作成功",
  "data": ""
}

备注

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

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

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

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

上传授权证件信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

添加授权证件信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

查询授权证件列表信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

修改授权证件信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

删除授权证件信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

查询授权证件信息

请求 URL：

请求方式：

参数形式：

参数：

返回：

返回示例

备注

相关帖子

随便看看

赞助商 我要投放

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

赞助商我要投放