我们能为您提供什么帮助?
续订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证书号。 |