RA2.0CS接口开发手册.docVIP

RA2.0C/S接口开发手册 概述 RA2.0 C/S接口采用Apache Axis来开发Web Service，可以完成B/S结构全部的证书管理功能，包括证书的申请、补发、换发、冻结、解冻、吊销、两码重发、制证以及证书查询等。 使用对象 使用C/S结构RA系统的开发人员。 使用方法 开发客户端应用程序时，先将CS客户端程序\lib目录下的包引入到客户端应用程序中。 如果应用程序运行在jdk1.3上，将CS客户端程序\xml 目录下的包引入到客户端应用程序中。如果jdk版本在1.3以上不要引入\xml目录下的包，否则会有包冲突。 RA系统C/S接口说明 4.1 证书申请 Public ReturnData certApply(CertApplyVO certApplyVO) 功能说明 提交一个证书申请请求，返回构造好的证书DN、参考号和授权码，如发生异常，则返回错误码和错误信息。 输入参数 CertApplyVO 包含 参数 类型 参数说明 是否必填 certTypeEname String 证书类型英文名（只能按下面内容设置参数） Customers – 个人普通 Business Customers - 个人高级证书 Enterprises – 企业普通 Units – 企业高级 Web Servers – Web服务器证书 是 userName String 用户名（长度限制：80） 是 engName String 用户英文名（长度限制：80） 是 idTypeCode String 证件类型编码（参照附件1） 是 userIdNo String 证件号 （长度限制：80） 是 email String 电子邮件 （长度限制：80） 是 address String 地址 （长度限制：80） 否 telNo String 电话号码 （长度限制：80） 否 organCode String 机构编码 （长度限制：20） 是 domainName String 域名（长度限制：80） 否（申请Web服务器证书时必填） extInfo String 扩展域值（长度限制：512） 否 输出参数 ReturnData 包含： 参数 类型 参数说明 dn String 证书DN refNo String 证书参考号 authCode String 证书授权码 errorCode String 错误码 errorInfo String 错误信息 错误码和错误信息 错误码 错误信息 该用户证书已经被申请 数据有效性检查 证书类型不能为空 数据有效性检查 该证书已经不存在，请重新查询 数据有效性检查 姓名不能为空 数据有效性检查 英文名不能为空 数据有效性检查 证件类型不能为空 数据有效性检查 证件编号不能为空 数据有效性检查 电子邮件地址不能为空 数据有效性检查 电子邮件地址格式不对 数据有效性检查 机构不能为空 数据有效性检查 域名不能为空 数据有效性检查 姓名长度超过数据库限制,长度不能超过80位 数据有效性检查 英文名长度超过数据库限制,长度不能超过80位 数据有效性检查 地址长度超过数据库限制,长度不能超过80位 数据有效性检查 电子邮件长度超过数据库限制,长度不能超过80位 数据有效性检查 域名长度超过数据库限制,长度不能超过80位 数据有效性检查 电话长度超过数据库限制,长度不能超过80位 数据有效性检查 证件号码长度超过数据库限制,长度不能超过80位 数据有效性检查 身份证号码只能是15位或18位 数据有效性检查 机构编码长度超过数据库限制,长度不能超过20位 数据有效性检查 域名长度超过数据库限制,长度不能超过80位 数据有效性检查 系统不支持的两码发送方式 数据有效性检查 系统不支持的证件类型 数据有效性检查 系统不支持的证书类型 数据有效性检查 扩展值长度超过数据库限制,长度不能超过512位 连接CA服务器失败 CA处理业务失败 释放CA连接失败 解析CA响应数据失败 CA拒绝