个人证书申请并下载

个人证书申请并下载

功能

证书申请接口,通过该接口可生成证书并且可以下载安装证书;

请求说明

l 请求方式:POST

请求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时回返回该字段