个人证书申请并下载
证书申请接口,通过该接口可生成证书并且可以下载安装证书;
l 请求方式:POST
l 请求URL:请求地址/cert/api/manage/applyDownPerson?token=${token}
参数名 | 类型 | 可空 | 说明 |
authInfo | String | 否 | 访问授权信息;JSON数据封装,格式范例: { "projectId":"378", "locationId":"4", "ip":"", "certsn":"5F64183039B45A8D", "authCode":"EFKEAKFafjkadf123" }
各属性说明如下: projectId:项目编号,必填。由CA运营商提供; locationId:受理网点,必填。由CA运营商提供; ip:暂时未空; certsn:证书序列号,必填。由CA运营商提供; authCode:客户授权码,必填。由CA运营商提供;
|
certApplyInfo | String | 否 | 证书申请基本信息;JSON数据封装,格式范例: { "certType":"PERSON", "certdn":"CN=张俊青,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 |
selfExtResArr | String | 是 | 自定义扩展(JSONArray): [ {\"extId\":\"1.2.86.11.7.1.8\", \"extName\":\"xxx\" \"extValue\":\"xxx\" \"nullAble\":\"xxx\"
}, {\"extId\":\"1.2.86.11.7.1.8\", \"extName\":\"xxx\" \"extValue\":\"xxx\" \"nullAble\":\"xxx\" }] |
p10 | String | 否 | P10 签名证书下载需要 |
tempPubKey | String | 是 | 临时公钥-加密证书下载需要 |
返回结果 | 说明 |
{ "success": true, "msg": "ok", "code": 0, "orderno": "1abdc1389a3a4bf49700adebccfe11e9", "obj": { "resultCode": "0", "resultDesc": "证书申请下载成功!", "signP7b": "MIIINQYJKoZIhvcN~~", "kmcP7b": "", "sessionKey": "", "sessionKeyType": "", "keyLength": "2048", "privateKey": "", "signCertSn": "1BF640F0D9B78887", "kmcCertSn": "", "isSaveprikey": "", "signP12": "", "enPwd": "", "startDate": "2019-10-14 15:28:14", "endDate": "2020-10-13 15:28:14", "uniqueIde": "", "szcaExtid": "", "npId": "", "list": [{ "applyId": "20191000008046", "subject": "CN=张三,OU=1235678,T=166117185000,L=城市名,ST=省,C=CN", "refId": "", "applyFlag": "-1", "multialgorithm": null, "sopin": null, "oldsopin": null, "keypwd": null, "ctmlcerttype": null, "keygenplace": null, "keylength": null, "keytype": null }] } } | obj: 业务返回结果; applyId:证书业务单号; signCertSn:签名证书序列号 signP7b:签名证书P7B数据 kmcCertSn:加密证书序列号 kmcP7b:加密证书P7B数据 privateKey:私钥 List:证书申请的返回信息 resultCode:申请返回结果;为0则申请成功; 其他编码则是业务异常,调用方需进行判断; resultDesc:异常信息,resultCode不为0时回返回该字段 |