关于SP一些响应码的API返回码及解析集合

Posted 孙叫兽

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了关于SP一些响应码的API返回码及解析集合相关的知识,希望对你有一定的参考价值。

在一些金融的行业(银行、证券、保险等),如果接触了一些中间件,比如长城、恒银、广电等一些厂商的设备,不同的厂商有不同的一些规范,在应用开发的过程中难免会和中间件的错误码打交道,这里总结一下。基本常用的设备就是智能柜台、ATM机等。

API返回值方面,执行成功返回0;执行失败,返回的错误码会根据模块类别进行区分,如摄像头类别的错误码为 -1000开始,依次延续为-1002……等;读卡器类别的错误码为 -200开始,依次延续为-201……等;能够明确归为类别错误码的情况返回相应的类别错误码;不能明确归类的返回通用错误码。


本API返回的错误码几乎都是按照WOSA规范返回的错误码,因此其他厂商接入本API时,其SP只需要按照标准的WOSA3.10规范制作接入即可。

通用错误码为各模块接口均可能报出的错误,其错误的原因是各模块的公共软件环境出现错误,具体的通用错误码说明如下:

PTR打印机类包含的设备模块有:激光打印机、凭条打印机、发票打印机、日志打印机、指纹仪等,有关这些模块可能返回的错误码有:

IDC读卡器类包含的设备模块有:电动读卡器、非接触式读卡器、插入式IC读卡器、刷卡器及发KEY模块的条码获取部分等,有关这些模块可能返回的错误码有:

PIN加密模块类包含的设备模块有:金属加密键盘、外接密码键盘等,有关这些模块可能返回的错误码有:

SIU指示灯传感器类包含的设备模块有:各模块的指示灯、人体红外感应、门开关传感器等,有关这些模块可能返回的错误码有:

CRD介质发放类包含的设备模块有:发卡模块、UKEY或TOKEN介质发放模块,有关这些模块可能返回的错误码有:

BCR条码扫描读取类主要包含条码和二维码扫描枪模块,有关这些模块可能返回的错误码有:

根据这些错误码,我们通过分析返回值的日志能很快定位到设备的故障,可以区分是软件问题还是硬件故障,便于给对应的工程师分配问题,让问题很好的得到解决。

在应用开发的过程中如果遇到和中间件以及硬件相关的问题,我们可以根据具体的问题,提取对应设备的日志,通过现象的反馈,查询对应的流水日志发生问题的流水号及报错的问题以及时间点。然后通过流水号和时间点去.all日志中查具体的返回值,对着上面的码表就能给出对应的措施及建议,一般来说,设备号就是流水日志的前8位。

好啦,本期中间件相关的API返回码知识孙叫兽就分享到这里,我们下期见!

以上是关于关于SP一些响应码的API返回码及解析集合的主要内容,如果未能解决你的问题,请参考以下文章

关于SP一些响应码的API返回码及解析集合

http返回状态码及含义

6月19 使用tp框架生成验证码及文件上传

HTTP常见响应状态码及解释常用请求头及解释

常用状态码

REST API 是不是应该始终返回带有消息的响应?