2.3 获取证书申请状态
2.3.1 Api信息
| 测试环境 | |
|---|---|
| 真实环境 | https://portal.racent.com/ssl/collect |
| 请求方式 | POST |
| content-type | multipart/form-data |
| 描述 | 此接口用于获取订购证书状态、获取证书、获取验证信息。 |
2.3.2 参数定义
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| certId | String | Y | racent证书id |
| api_token | String | Y | 身份凭据,生成token请联系锐成技术支持。 |
函数返回
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | Y | 返回状态,具体详解请参见附录3.1 |
| status | String | Y | 订单状态: PENDING:申请中 COMPLETE:申请成功 CANCELLED:已取消 REISSUED:已重签 FAILED:申请失败 RENEWED:已续费 REVOKED:已吊销 |
| certStatus | String | Y | 证书状态: PENDING:申请中 COMPLETE:申请成功 CANCELLED:已取消 REISSUED:已重签 FAILED:申请失败 RENEWED:已续费 REVOKED:已吊销 |
| data | Object | N | 返回数据,以下为具体详情 |
| failReason | Object | N | 当状态为FAILED时,该参数为Y,失败原因 |
| dataReasons | Array | N | 数据原因 |
| key | String | N | 项目 |
| reason | String | N | 原因 |
| sysReason | String | N | 系统原因 |
| beginDate | String | N | 当状态为COMPLETE时,该参数为Y,证书开始时间 |
| endDate | String | N | 当状态为COMPLETE时,该参数为Y,证书结束时间 |
| certificate | String | N | 当状态为COMPLETE时,该参数为Y,pem证书 |
| caCertificate | String | N | 当状态为COMPLETE时,该参数为Y,pem中间证书 |
| jks | String | N | 当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,jks证书内容的base64编码。 |
| jksPass | String | N | 当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,jks的证书密码。 |
| pkcs12 | String | N | 当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,PKCS12证书内容的base64编码。 |
| pkcsPass | String | N | 当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,PKCS12的证书密码。 |
| privateKey | String | N | 当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,私钥信息 |
| rsaPrivateKey | String | N | rsa格式私钥,当状态为COMPLETE时,并racent有正确的私钥信息,该参数为Y,私钥信息 |
| replaceCertId | String | N | 当状态为REISSUED时,该参数为Y, 重签后的racent证书id |
| oldCertId | String | N | 当申请证书为重签证书时,该参数为Y, 老的racent证书id |
| vendorId | String | N | CA订单号 |
| vendorCertId | String | N | CA证书号(sectigo订单号) |
| DCVfileName | String | N | 域文件验证,文件名 |
| DCVfileContent | String | N | 文件验证,文件内容 |
| DCVdnsHost | String | N | DNS验证,host |
| DCVdnsValue | String | N | DNS验证 value |
| DCVdnsType | String | N | DNS验证 type |
| dcvInfo | Object | N | 申请证书中的每个域名验证值不一样时,此项为Y 每项类型为Object,每项对象名为申请得域名,如:racent.com。每项详情如下: |
| DCVfileName | String | N | 域文件验证,文件名 |
| DCVfileContent | String | N | 文件验证,文件内容 |
| DCVdnsHost | String | N | DNS验证,host |
| DCVdnsValue | String | N | DNS验证 value |
| DCVdnsType | String | N | DNS验证 type |
| DCVfilePath | String | N | 文件验证文件路径 |
| dcvList | Array | N | 域名验证列表,每项类型为Object,每项详情如下: |
| domainName | String | N | 域名 |
| dcvMethod | String | N | 域名验证方法 |
| dcvEmail | String | N | 域名验证邮箱 |
| is_verify | String | N | 已验证参数值为“verified”,未验证无参数 |
| application | Object | N | 提交订单状态 |
| status | String | N | 参数为以下值之一: notdone:未完成 done:已完成 ongoing:进行中 |
| dcv | Object | N | 域名验证状态 |
| status | String | N | 参数为以下值之一: notdone:未完成 done:已完成 ongoing:进行中 |
| ov | Object | N | 组织验证状态 |
| status | String | N | 参数为以下值之一: notdone:未完成 done:已完成 ongoing:进行中 |
| issued | Object | N | 颁发状态 |
| status | String | N | 参数为以下值之一: notdone:未完成 done:已完成 ongoing:进行中 |
| applyParams | Object | N | 申请参数,具体请参考申请接口(place)请求参数 |
| csr | String | N | csr |
| Administrator | Object | N | 管理员信息 |
| job | String | N | 职位 |
| city | String | N | 城市 |
| String | N | 邮箱 | |
| state | String | N | 省或州 |
| mobile | String | N | 联系方式 |
| address | String | N | 联系地址 |
| country | String | N | 国家( ISO 3166-1标准中的 双字母代码)。 |
| lastName | String | N | 姓 |
| postCode | String | N | 邮编 |
| firstName | String | N | 名字 |
| organation | String | N | 公司名称 |
| idType | String | N | 证件类型。CFCA此项为Y。 值如下: SFZ:身份证 HZ:护照 |
| idNumber | String | N | 证件号码。CFCA此项为Y。 |
| tech | Object | N | 技术员信息,具体项和管理员信息一致 |
| finance | Object | N | 财务员信息,具体项和管理员信息一致 |
| organizationInfo | Object | N | 公司信息 |
| organizationCity | String | N | 城市 |
| organizationName | String | N | 名称 |
| organizationMobile | String | N | 电话 |
| organizationAddress | String | N | 地址 |
| organizationCountry | String | N | 国家 |
| organizationPostCode | String | N | 邮编 |
| organizationRegNumbe | String | N | 公司证件号码。CFCA此项为Y。 |
| idType | String | N | 公司证件类型。CFCA此项为Y。 值如下: TYDMZ:统一社会信用代码 OTHERS:其他 |
| errors | Object or String | N | 当返回状态为错误时,具体错误信息。 |