个人证书申请

 功能

证书申请接口,用于软证书的申请。

请求说明

l  请求方式:POST

l  请求URL:请求地址/cert/api/sup/apply?token=${token}

参数以及返回说明

参数名

类型

可空

说明

authInfo

String

访问授权信息;JSON数据封装,格式范例:

{

"projectId":"801",

"locationId":"12",

"ip":"",

"certsn":"5F64183039B45A8D",

"authCode":"EFKEAKFafjkadf123"

}

各属性说明如下:

projectId:项目编号,必填。由CA运营商提供;

locationId:受理网点,必填。由CA运营商提供;

ip:暂时未空;

certsn:证书序列号,必填。由CA运营商提供;

authCode:客户授权码,必填。由CA运营商提供;

certApplyInfo

String

证书申请基本信息;JSON数据封装,格式范例:

{

"certType":" NATURAL ",

"certdn":" CN=自然人姓名,OU=自然人身份证号码后8,O=自然人姓名,L=杭州市,ST=浙江省,C=CN ",

"applyValidate":365,

"certValidate":365,

"email":"zhangjq@szca.com.cn"

}

各属性说明如下:

certType:证书类型,在此为固定值PERSON;必填

certdn:证书主题;必填

applyValidate:证书申请服务期限;单位为天;必填

certValidate:证书申请有效期;单位为天;必填

email:邮箱地址;必填

businessInfo

String

业务信息;JSON数据封装,格式范例:

{

"chargeMethod":"FREE",

"isPrecord":"N",

"deliverMethod":"SELF"

}

各属性说明如下:

chargeMethod:收费方式;

planKeyFee:应收介质费用

planCertFee:应收证书费用

factKeyFee:实收介质费用

factCertFee:实收证书费用

planOpenFee:应收开户费

factOpenFee:实收开户费

deliverMethod:领取方式

postAddr:邮寄地址

expressId:快递单号

postCode:邮政编码

contacter::联系人

cntPhoneNo::联系电话

isPrecord::是否预登记

refId:参考标识

remitId::汇款单号

checkRemarks:核对时备注

以上参数正式环境中需由根据商务合同决定;

测试环境中按格式范例提供的即可;

personInfo

String

个人客户信息;JSON数据封装,格式范例:

{

"custName":"张三",

"sex":"M",

"idType":"SF",

"idNo":"431431198203055517",

"mobileNo":"13560767212",

"phoneNo":"075526588388",

"faxNo":"075586156366",

"company":"深圳市电子商务有限公司",

"companyCode":"123456789",

"address":"深圳市南山区软件园",

"zipCode":"518057",

"city":"深圳市",

"province":"广东省"

}

各属性说明如下:

custName:客户名称

sex:性别;

idType:证件类型

idNo:证件号码

mobileNo:手机号码

phoneNo:电话号码

faxNo:传真号码

company:单位名称

companyCode:公司机构代码

address:联系地址

zipCode:邮政编码

city:城市

province:省份

keyType

String

证书类型;输入值可选范围为:RSA;SM2

返回结果

说明

{

    "success": true,

    "msg": "ok",

    "code": 0,

    "orderno": "e7bb301f2b164fb784fc54ae38cba540",

    "obj": {

        "applyid": "201907001",

        "endDate": "2020-07-10 18:31:52",

        "subject": "CN=张三201907,OU=431431198203055517,O=张三201907,L=杭州市,ST=浙江省,C=CN",

        "resultCode": 0,

        "startDate": "2019-07-11 18:31:52"

    }

}

obj: 业务返回结果;

applyId:证书业务单号;

subject:证书主题;

resultCode:申请返回结果;为0则申请成功;

其他编码则是业务异常,调用方需进行判断;

resultDesc:异常信息,resultCode不为0时回返回该字段