养老保险待遇状态比对查询服务系统接口开发手册汇.docVIP

养老保险待遇状态比对查询服务系统 接口开发手册 （1.0版） 2011.7.25 目 录 1 接口API使用说明 1 1.1 接口API概述 1 2 JAVA接口使用说明 1 2.1 JAVA接口类列表 1 2.2 Java接口API说明 2 2.2.1 上传 2 FileUploadAgent 2 FileUploadParams 3 FileUploadResponse 6 2.2.2 通用查询 7 CommQueryAgent 7 CommQueryResponse 9 2.2.3 错误文件下载 11 ErrFileDownloadAgent 11 ErrFileDownloadParams 12 ErrFileDownloadResponse 14 2.2.4 证书有效期查询 16 CertQueryAgent 16 2.3 Java接口开发举例 16 2.3.1 领取人员批量查询 16 领取人员批量查询上传 16 通用查询（查询领取待遇人员批量查询结果） 17 错误文件列表查询 17 错误文件下载 18 3 C接口使用说明 19 3.1 C接口API说明 19 3.1.1 上传 19 FileUploadAgentInit 19 SetFileUploadParams 19 FileUploadSendAndReceive 20 GetFileUploadResponse 20 FileUploadAgentEnd 21 3.1.2 通用查询 21 CommQueryAgentInit 21 SetCommQueryParams 21 CommQuerySendAndReceive 22 GetCommQueryResponse 22 CommQueryAgentEnd 23 3.1.3 错误文件下载 23 ErrFileDownloadAgentInit 23 setErrFileDownloadParams 23 ErrFileDownloadSendAndReceive 24 GetErrFileDownloadResponse 24 ErrFileDownloadAgentEnd 25 3.1.4 证书有效期查询 25 GetCertPeriod 25 附录1比对查询系统反馈的错误代码列表 1 附录2：接口反馈代码 2 附录3：查询条件列表 6 附录4：开发常见问题及解答 8 接口API使用说明 接口API概述 在采用嵌入式或前置系统接入模式下，基于本手册进行本地后台接口的开发。 比对查询业务接口API提供了基于Java和C语言的两种接口封装形式，各地可根据本地业务管理系统的开发环境选用。Java接口采用Jar包形式，C语言采用动态链接库dll形式并提供开发需要的.h头文件和.lib库文件。 在实际的运行环境中，需要将jar或者dll文件部署到使用比对查询业务接口的系统库文件目录内，部署接口api的服务器必须能够通过网络直接访问部级养老保险待遇状态比对查询服务系统进行数据交换，同时由于接口会自动对传输的数据进行数字签名，需要在此服务器上部署安装金保工程统一的设备数字证书以及相关认证软件包。 JAVA接口使用说明 JAVA接口类列表 接口名称 接口描述 FileUploadAgent 文件上传代理 FileUploadParams 上传文件参数对象 FileUploadResponse 上传文件结果返回对象 CommQueryAgent 通用查询代理 CommQueryResponse 通用查询返回对象 ErrFileDownloadAgent 下载错误文件代理 ErrFileDownloadParams 下载错误文件参数对象 ErrFileDownloadResponse 下载错误结果返回对象 CertQueryAgent 查询证书有效期对象 Java接口API说明 Jar包名称：sitrb.jar 依赖包：Axis 1.4 开发环境要求：支持Eclipse等各类Java开发工具，J2SE1.4及以上版本。 运行环境要求：JRE1.4以及上版本，可以部署在J2EE容器内运行。 上传 FileUploadAgent 上传文件代理类，上传文件时调用此类。 构造方法摘要 FileUploadAgent() 初始化一个建新的FileUploadAgent对象。 方法摘要 FileUploadResponse sendAndReceive(FileUploadParams upParams) 将请求信息发送给服务器,并返回一个FileUploadResponse对象。 构造方法详细信息 FileUploadAgent p