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

Posted 2022-01-14 孙叫兽

在一些金融的行业（银行、证券、保险等），如果接触了一些中间件，比如长城、恒银、广电等一些厂商的设备，不同的厂商有不同的一些规范，在应用开发的过程中难免会和中间件的错误码打交道，这里总结一下。基本常用的设备就是智能柜台、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返回码知识孙叫兽就分享到这里，我们下期见！