2.21 修改申请资料
2.21.1 Api信息
| 测试环境 | |
|---|---|
| 真实环境 | https://portal.racent.com/ssl/alter | 
| 请求方式 | POST | 
| content-type | multipart/form-data | 
| 描述 | 此接口仅用于CFCA证书申请失败,修改申请资料。 | 
2.21.2 参数定义
| 参数名称 | 参数类型 | 必填 | 说明 | 
|---|---|---|---|
| api_token | String | Y | 身份凭据,生成token请联系锐成技术支持。 | 
| certId | String | Y | racent证书id | 
| refId | String | N | 客户提供的唯一客户订单号 | 
| verificationPic | File | N | 备用验证材料。用于组织验证,支持 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip格式,内容不超过2M。 | 
| domainVerificationPic | File | N | 当域名验证方式为:VERIFY_DOCUMENT,此项为Y。用于域名所有权验证(目前仅支持CFCA)。 | 
| params | String | Y | 订购信息,具体描述如下 | 
| csr | String | N | 当参数为空时,会为你生成csr,并保存私钥。 | 
| privateKey | String | N | 私钥。 | 
| server | String | N | 服务器。仅与SSL证书相关。SSL证书参数为Y,其他类型产品参数为N。若不需要此参数,请默认“other”。 | 
| orgCheck | Int | N | 值为0或1。当值为1时,将根据你提交的组织信息检索你账号下的所有组织,如果存在则使用存在组织的关联信息,如果不存在我们将其保存为新的组织。当值为0时,不保存组织信息。 | 
| duplicateOrgCheck | Int | N | 值为0或1。该参数目前仅与Digicert SSL证书相关。用于判断是否复用之前验证通过的组织和域名信息。当值为1时,复用。当值为0时,新建。默认为1。 | 
| dcvMethod | String | N | 统一设置申请域名验证方式。 必须为以下四种方式之一: EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) VERIFY_DOCUMENT(域名证书证明,仅支持CFCA) CFCA该项为Y | 
| domainInfo | String | N | 域名信息,仅与SSL证书相关。SSL证书参数为Y,其他类型参数为N。 标准域名总数和通配符域名总数,分别不能超出购买的标准域名总数和通配符域名总数。 示例: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] 具体描述如下: | 
| dcvMethod | String | N | 域名验证方式。 必须为以下四种方式之一: EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) 当上级dcvMethod不存在时,此项为Y。 当上级dcvMethod存在,该项也存在,会优先使用上级dcvMethod | 
| dcvEmail | String | N | 域名验证邮箱。 该项为N时,缺省情况如下 racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com | 
| domainName | String | N | 域名 | 
| organizationInfo | String | N | 公司信息。当订购需企业验证类产品,此参数为Y。示例如下: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }" | 
| organizationCity | String | N | 公司所在城市。 | 
| organizationName | String | N | 公司名称。 | 
| organizationMobile | String | N | 公司电话。 | 
| organizationAddress | String | N | 公司地址。 | 
| organizationCountry | String | N | 公司所在国家( ISO 3166-1标准中的 双字母代码)。 | 
| organizationPostCode | String | N | 公司所在地邮编。 | 
| organizationRegNumbe | String | N | 公司证件号码。CFCA此项为Y。 | 
| idType | String | N | 公司证件类型。CFCA此项为Y。 值如下: TYDMZ:统一社会信用代码 OTHERS:其他 | 
| Administrator | String | Y | 管理员信息、联系人。当申请代码签名、邮件签名、文档签名时,此参数作为申请信息。另外如csr为N,该信息作为csr的生成信息。 { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | 
| job | String | Y | 管理员职位。 | 
| city | String | Y | 管理员所在城市。 | 
| String | Y | 管理员的邮箱。 | |
| state | String | Y | 管理员所在省或州。 | 
| mobile | String | Y | 管理员联系方式。 | 
| address | String | Y | 管理员联系地址。 | 
| country | String | Y | 管理员所在国家( ISO 3166-1标准中的 双字母代码)。 | 
| lastName | String | Y | 管理员姓。 | 
| postCode | String | Y | 管理员所在地邮编。 | 
| firstName | String | Y | 管理员名字。 | 
| organation | String | Y | 管理员公司名称。 | 
| idType | String | N | 证件类型。CFCA此项为Y。 值如下: SFZ:身份证 HZ:护照 | 
| idNumber | String | N | 证件号码。CFCA此项为Y。 | 
| finance | String | 仅与SSL证书相关。 财务人员信息。可以与管理员信息一致。当订购产品非dv类型时,此参数为Y。 { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | |
| 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 | String | N | 仅与SSL证书相关。 技术员信息。当订购产品非dv类型时,此参数为Y。 { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | 
| 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。 | 
函数返回
| code | Int | Y | 返回状态,具体详解请参见附录3.1 | 
|---|---|---|---|
| errors | Object or String | N | 当返回状态为错误时,具体错误信息。 | 
| data | Object | N | 当返回状态为成功时,此参数为Y。具体描述如下: | 
| certId | String | N | racent证书id。请妥善保管,此参数为racent实例唯一凭据。 | 
| vendorId | String | N | CA订单号。 | 
| vendorCertId | String | N | CA证书号。 | 
| DCVfileName | String | N | 文件验证文件名 | 
| DCVfileContent | String | N | 文件验证文件内容 | 
| DCVdnsHost | String | N | Dns验证主机值 | 
| DCVdnsValue | String | N | Dns验证记录值 | 
| DCVdnsType | String | N | Dns验证记录类型 | 
| DCVfilePath | String | N | 文件验证文件路径 | 
| dcvInfo | Object | N | 申请证书中的每个域名验证值不一样时,此项为Y 每项类型为Object,每项对象名为申请得域名,如:racent.com。每项详情如下: | 
| DCVfileName | String | N | 文件验证文件内容 | 
| DCVfileContent | String | N | 文件验证文件内容 | 
| DCVdnsHost | String | N | Dns验证主机值 | 
| DCVdnsValue | String | N | Dns验证记录值 | 
| DCVdnsType | String | N | Dns验证记录类型 | 
| DCVfilePath | String | N | 文件验证文件路径 | 
| failReason | Object | N | 当锐成向CA申请证书失败,并能明确了失败原因,会返回此项。 | 
| dataReasons | Array | N | 数据原因 | 
| key | String | N | 项目 | 
| reason | String | N | 原因 | 
| sysReason | String | N | 系统原因 |