我们能为您提供什么帮助?
续订SSL订阅
API信息
| 测试环境 | |
| 真实环境 | https://portal.racent.com/ssl/renew |
| 请求方式 | POST |
| content-type | multipart/form-data |
| 描述 | 此接口用于续订SSL订阅。只有当SSL订阅状态为已签发并且30天内将过期的订阅,才允许被续订。 |
参数定义
| 参数名称 | 参数类型 | 必填 | 说明 | ||||
| api_token | String | Y | 身份凭据,生成token请联系锐成技术支持。 | ||||
| renewId | String | Y | racent证书id | ||||
| years | Int | Y | 续订年限(目前只支持1,2,3,4,5,6),根据具体产品而定。 | ||||
| refId | String | N | 客户提供的唯一客户订单号 | ||||
| params | Json | Y | 订购信息,具体描述如下 | ||||
| csr | String | N | 当参数为空时,会为你生成csr,并保存私钥。 | ||||
| privateKey | String | N | 私钥。 | ||||
| server | String | N | 服务器。仅与SSL证书相关。SSL证书参数为Y,其他类型产品参数为N。若不需要此参数,请默认“other”。请您使用如下服务器类型之一:apachessl citrix domino ensim hsphere iis4 iis6 iis7 iplanet javawebserv netscape ibmhttp novel oracle plesk tomcat webstar whmcpane other apache2 c2net cisco cobaltseries nginx apacheraven redhatsap website zeusv3 | ||||
| uniqueValue | String | N | 仅与Sectigo产品相关。1-20个字符(a-z A-Z 0-9)用于分销商自主生成验证值。 | ||||
| domainInfo | Json 数组 | N | 域名信息,仅与SSL证书相关。SSL证书参数为Y,其他类型参数为N。示例: [{ “dcvEmail”: “[email protected]”, “dcvMethod”: “EMAIL”, “domainName”: “www.xxx.com” }, { “dcvEmail”: “[email protected]”, “dcvMethod”: “EMAIL”, “domainName”: “aaa.com” }, { “dcvEmail”: “[email protected]”, “dcvMethod”: “EMAIL”, “domainName”: “racent.com” }]具体描述如下: | ||||
| dcvMethod | String | N | 域名验证方式。必须为以下四种方式之一: EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) | ||||
| dcvEmail | String | N | 域名验证邮箱。当验证方式为EMAIL时,此项为Y。 | ||||
| domainName | String | N | 域名 | ||||
| organizationInfo | Json | 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 | 公司所在国家。 | ||||
| organizationPostCode | String | N | 公司所在地邮编。 | ||||
| Administrator | Json | Y | 管理员信息、联系人。当申请代码签名、邮件签名、文档签名时,此参数作为申请信息。另外如csr为N,该信息作为csr的生成信息。{“job”: “总经办”, “city”: “上海市”, “email”: “[email protected]”, “state”: “上海市”, “mobile”: “18111111111”, “address”: “上海市”, “country”: “CN”, “lastName”: “zhang”, “postCode”: “401320”, “firstName”: “nick”, “organization”: “某公司”} | ||||
| job | String | Y | 管理员职位。 | ||||
| city | String | Y | 管理员所在城市。 | ||||
| String | Y | 管理员的邮箱。 | |||||
| state | String | Y | 管理员所在省或州。 | ||||
| mobile | String | Y | 管理员联系方式。 | ||||
| address | String | Y | 管理员联系地址。 | ||||
| country | String | Y | 管理员所在国家。国家编码见附录。 | ||||
| lastName | String | Y | 管理员姓。 | ||||
| postCode | String | Y | 管理员所在地邮编。 | ||||
| firstName | String | Y | 管理员名字。 | ||||
| organization | String | Y | 管理员公司名称。 | ||||
| finance | Json | 仅与SSL证书相关。财务人员信息。可以与管理员信息一致。当订购产品非dv类型时,此参数为Y。{“job”: “财务部”, “city”: “上海市”, “email”: “[email protected]”, “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 | 财务员所在国家。 | ||||
| lastName | String | N | 财务员姓。 | ||||
| postCode | String | N | 财务员所在地邮编。 | ||||
| firstName | String | N | 财务员名字。 | ||||
| organization | String | N | 财务员所在公司。 | ||||
| tech | Json | N | 仅与SSL证书相关。技术员信息。当订购产品非dv类型时,此参数为Y。{“job”: “技术部”, “city”: “上海市”, “email”: “[email protected]”, “state”: “上海市”, “mobile”: “18111111111”, “address”: “上海市”, “country”: “CN”, “lastName”: “zhang”, “postCode”: “401320”, “firstName”: “nick”, “organization”: “某公司”} | ||||
| job | String | N | 技术员职位。 | ||||
| city | String | N | 技术员所在城市。 | ||||
| String | N | 技术员的邮箱。 | |||||
| state | String | N | 技术员所在省或州。 | ||||
| mobile | String | N | 技术员联系方式。 | ||||
| address | String | N | 技术员联系地址。 | ||||
| country | String | N | 技术员所在国家。 | ||||
| lastName | String | N | 技术员姓。 | ||||
| postCode | String | N | 技术员所在地邮编。 | ||||
| firstName | String | N | 技术员名字。 | ||||
| organization | String | N | 技术员所在公司。 | ||||
| 函数返回 | |||||||
| code | Int | Y | 返回状态,具体请见附录响应代码。 | ||||
| errors | Array or String | N | 当返回状态为错误时,具体错误信息。 | ||||
| data | Json | N | 当返回状态为成功时,此参数为Y。具体描述如下: | ||||
| certId | String | N | racent证书id。请妥善保管,此参数为racent实例唯一凭据。 | ||||
| vendorId | String | N | CA订单号。 | ||||
| vendorCertId | String | N | CA证书号。 | ||||