警备通警用装备管理系统软件接口文档Word文档下载推荐.docx
《警备通警用装备管理系统软件接口文档Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《警备通警用装备管理系统软件接口文档Word文档下载推荐.docx(16页珍藏版)》请在冰点文库上搜索。
●报文中的二进制数据(如文件对象),转换成Base64字符方式发送;
●如果返回结果数据集非常多,在性能考虑和数据量冲突的情况下,可以使用分页返回数据集的方式分批返回数据(每次返回最多100条记录)。
服务端提供分批结果返回的功能。
1.4容错处理
客户端向服务端发送数据,服务端解析数据,反馈信息给客户端,这中间的环节只要某一个环节出现问题,都会造成接口的失败。
按照失败产生的环节分类,我们可以从三个方面来处理接口的失败。
●网络连接失败:
在调用接口的时候,由于网络不通,造成数据不能正常传输。
这样,客户端应该能够记录发送的日志,按照一定的时间间隔重试发送。
本方案定为重试发送20次,每次时间间隔2小时。
如果一直发生网络不通的情况,该发送日志被保存下来,待后手工发送。
所以,客户端系统应该实现手工发送数据的功能。
●反馈错误信息:
服务端在解析数据包,执行数据包业务的时候,可能会发生异常。
所以,服务端应当能够捕捉异常信息,比如“非法XML格式”等,然后反馈给客户端。
客户端在接受到这类的错误信息之后,应当进行日志记录,能够自动或手工分析异常的信息。
●网络连接正常,但是无信息反馈:
这种情况下,一般是服务端出现了异常,但是又没有捕捉到的情况下发生。
这种情况下,客户端把这种错误当作“网络连接失败”来处理。
服务端应能够实现相同数据包重新发送过来的处理机制。
1.5通用错误返回码
返回码
表示
说明
200
请求正常
401
Token鉴权失败
获取Token令牌时,验证用户名密码失败
403
Token验证失败
执行接口请求时,Token不存在或失效
405
参数校验失败
执行接口请求时,出现参数缺失、格式错误
2.接口定义
2.1AccessToken鉴权接口
2.1.1接口定义
Token是服务端的全局唯一接口调用凭据,客户端调用服务端各接口时都需使用,Token的有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的Token失效。
URL
http:
//*****/webapi/token?
username={username}&
password={password}
协议
http
请求方式
GET/POST
2.1.2参数说明
参数名称
是否必须
类型
描述
username
必选
String
第三方用户唯一凭证
password
第三方用户唯一凭证密钥
2.1.3返回结果
正常情况下,服务端会返回下述JSON数据包给客户端:
{"
access_token"
:
"
ACCESS_TOKEN"
"
expires_in"
7200}
参数说明:
access_token
获取到的令牌凭证
expires_in
凭证有效时间,单位:
秒
2.2装备库存明细查询接口
2.2.1接口定义
该接口由“警备通”提供,用于外部系统调取设备数据。
//*****/webapi/equitment/inventory
GET
2.2.2参数说明
token
通过获取鉴权Token接口返回
warehouseId
所属装备室
offset
int
分页起始位置
size
选填
每页查询数量,大于100时按100条返回
2.2.3返回结果
响应参数说明:
code
错误码,200代表成功
message
错误信息
equitments
数组类型,装备列表
equitmentName
装备名称
warehouseName
装备室名称
equitmentNo
装备编号
equitmentType
装备分类
brand
装备品牌
specification
装备规格型号
prescribedQuan
装备规定数量
totalStorage
装备总入库量
totalOut
装备总出库量
remaining
装备剩余库存
maintenance
装备保养周期
check
装备点验周期
position
装备存储位置
price
装备价格
totalScrap
总处置数
2.3个人持有明细接口查询
2.3.1接口定义
//*****/webapi/equitment/personal
2.3.2参数说明
userId
所属警员
2.3.3返回结果
装备持有人
holdingTime
持有时间
purchaseTime
购置时间
购置价格
expiration
过期时间
equipmentStatus
装备状态
lastmaintenanceTime
最后维护时间
2.4装备入库明细接口查询
2.4.1接口定义
该接口由“警备通”提供,用于外部系统调取装备入库明细数据。
//*****/webapi/equitment/warehousing
2.4.2参数说明
2.4.3返回结果
usageTime
使用年限
statusUse
使用状态
manager
经办人
storageTime
入库日期
2.5装备领用明细接口查询
2.5.1接口定义
该接口由“警备通”提供,用于外部系统调取装备领用明细数据。
//*****/webapi/equitment/receiving
2.5.2参数说明
2.5.3返回结果
employer
领用人
reasonsAdoption
领用缘由
returnStatus
归还状态
returnee
归还人
returnTime
归还时间
takeTime
领用时间
2.6装备交接明细接口查询
2.6.1接口定义
该接口由“警备通”提供,用于外部系统调取装备交接明细数据。
//*****/webapi/equitment/handover
2.6.2参数说明
2.6.3返回结果
deliverer
交付人
delivererUnit
交付人单位
receiver
接收人
recipientUnit
接收人单位
reasonHandover
交接原因
handoverDate
交接日期
2.7装备点验明细接口查询
2.7.1接口定义
该接口由“警备通”提供,用于外部系统调取装备点验明细数据。
//*****/webapi/equitment/check
2.7.2参数说明
2.7.3返回结果
checkNo
点验数
checkPerson
点验人
checkContent
点验内容
checkDate
点验日期
2.8装备维护明细接口查询
2.8.1接口定义
该接口由“警备通”提供,用于外部系统调取装备维护明细数据。
//*****/webapi/equitment/maintain
2.8.2参数说明
2.8.3返回结果
approver
批准人
维护人
maintenanceContent
维护内容
maintenanceDate
维护日期
2.9装备处置明细接口查询
2.9.1接口定义
该接口由“警备通”提供,用于外部系统调取装备维处置明细数据。
//*****/webapi/equitment/dispose
2.9.2参数说明
2.9.3返回结果
购置日期
serviceLife
过期日期
reasonScrap
报废原因
disposalMethod
处置方式
disposalDate
处置日期
2.10数据摘要查询接口
2.10.1接口定义
该接口由“警备通”提供,用于外部系统调取装备数据摘要信息。
//*****/webapi/dataSummary
2.10.2参数说明
2.10.3返回结果
totalEquipment
总装备数
equipmentClass
装备分类数
storageToday
今日入库数
outboundToday
今日出库数
maintenanceToday
今日维护数
checkToday
今日点验数
storageWeek
本周入库数
outboundWeek
本周出库数
maintenanceWeek
本周维护数
checkWeek
本周点验数