《(2020年）(售后服务）中国结算CA系统对外服务接口开发使用文档》由会员分享，可在线阅读，更多相关《(2020年）(售后服务）中国结算CA系统对外服务接口开发使用文档（91页珍藏版）》请在金锄头文库上搜索。
1、北京信安世纪科技有限公司中国结算CA系统对外服务接口开发使用文档北京信安世纪科技有限公司目录1基本功能42接口描述42.1接口约定42.2接口定义52.2.1申请证书52.2.1.1个人证书52.2.1.2企业证书112.2.1.3企业员工证书172.2.2更新证书222.2.2.1个人证书222.2.2.2企业证书262.2.2.3企业员工证书312.2.3补办证书352.2.3.1个人证书352.2.3.2企业证书392.2.3.3企业员工证书432.2.4冻结证书472.2.4.1个人证书472.2.4.2企业证书492.2.4.3企业员工证书502.2.5解冻证书522.2.5.1个人
2、证书522.2.5.2企业证书542.2.5.3企业员工证书552.2.6作废证书572.2.6.1个人证书572.2.6.2企业证书592.2.6.3企业员工证书602.2.7查询证书622.2.7.1个人证书622.2.7.2企业证书652.2.7.3企业员工证书672.2.8查询用户及证书信息692.2.8.1个人用户及证书692.2.8.2企业用户及证书722.2.8.3企业员工及证书752.2.9证书下载78附录1证书类型81附录2证书状态82附录3个人身份证件类型83附录4 机构证件类型84附录5证书DN85附录6名词解释86附录7国籍（地区）代码88附录8错误码定义94附录9证书
3、申请方式97修订历史记录RevisionAuthor/ModifierCommentsNo.Date2013-05-14jhliu/zhenggg4信安世纪信息技术有限公司 开发技术文档 第 94 页 共97页1 基本功能中国证券登记结算有限责任公司（以下简称：中国结算）CA系统对外服务支持多个证书代理服务机构的接入，同时能够管理和连接多个CA系统，并能对接入的所属机构的个人和企业信息进行管理，提供证书的申请、更新、作废、冻结、解冻、补办和下载等操作，以及证书统计和查询等操作功能。中国结算CA系统概述详见中国结算CA系统准入测试方案。2 接口描述2.1 准备环境所需资源：Windows系统（w
4、in7系统）iconv-1.9.2.win32openssl-1.0.0d安装vs2005。其中，iconv-1.9.2.win32和openssl-1.0.0d已在项目工程文件下的lib文件夹中，项目工程已经配置了该路径，只需运行工程即可。2.2 接口定义2.2.1 申请证书2.2.1.1 个人证书2.2.1.1.1 申请返回两码（后续需要调用证书下载的接口）WebService调用方法：int perCertRequest( PERSONINFO personReq, char serial128 , PROCESSRESULT* processresult)接口参数参数名称personR
5、eq：请求XML消息报文；Serial：序列号；包含两码的返回结果：processresult示例请求XML消息报文：11000200030004000张三12013050920250001SHA1withRSAhk2QnDmaRCBXc1f65/N7MM8NFyWp0PC4nqZGdAnCAtHwOfn46jpPIq0KAoEYuN9dZ+SjbSv2FTkoA8dezFfskCXk1gxuurWpHIglvtD1bEk+83sNNIRHoGXQylhocd2K2KZAtLa5nuH331nmxndxT0mlX/HefoHa9Sviyd7YaEw=CN=100110011000000001,
6、OU=Acess,O=CSDCCA,C=CN参数说明字段名最大长度是否必选说明caid1是连接CA IDRSA算法CA（目前不开放其他算法CA）transactioncode20是交易流水号机构生成，4位机构号8位机构号+随机码，机构编号为机构组织代码证的前8位，RAServer不判断唯一性accountholdername128是账户持有人名称用户信息1）账户持有人名称2）国籍3）第一证件类型4）第一证件号为关键要素，确认一张个人用户证书。申请后不能修改accountholderabbre32否账户持有人简称nationality8是国籍（附录7）cardtype12是第一证件类型（附录3）
7、cardnum132是第一证件号cardissuingauthority1128否第一证件发证机关cardexpirationtime114否第一证件失效时间cardtype22否第二证件类型（附录3）cardnum232否第二证件号cardissuingauthority2128否第二证件发证机关cardexpirationtime214否第二证件失效时间cardtype32否第三证件类型（附录3）cardnum332否第三证件号cardissuingauthority3128否第三证件发证机关cardexpirationtime314否第三证件失效时间headpic2048否投资者头像fi
8、ngerprint2048否指纹信息mobilephone20否手机mail64否邮件certtype2是请求证书类型（见附录1证书类型）timestamp14是申请时间时间格式：yyyyMMddHHmmss（由机构保证，RA不验证日期格式）requesttype2是证书申请方式（附录9）signAlg20是签名算法请求签名信息，请求签名信息，对参数内进行签名（含）signValue1024是签名值(使用机构接入证书签名)signCertDN128是机构接入证书DN对应于上面的消息报文，构造结构体PERSONINFO如下：typedef struct personinfo_s /=开始进行个人
9、用户证书申请操作=char Accountholdername132;/账户持有人名称char Accountholderabbre36;/账户持有人简称char Nationality64; /国籍编号（参看中登接口附录）char Cardtype14; /第一证件类型（参看中登接口附录）char Cardnum136; /第一证件号char Cardissuingauthority1132; /第一证件发证机关char Cardexpirationtime116; /第一证件失效时间char Cardtype24; /第二证件类型（参看中登接口附录）char Cardnum236; /第二证件编号char Cardissuingauthority2132; /第二证件发证机关char Cardexpirationtime216; /第二证件失效时间char Cardtype34; /第三证件类型（参看中登接口附录）char Cardnum336; /第三证件编号char Cardissuingauthority3132; /第三证件发证机关char Card
