订购证书

测试环境

真实环境

https://portal.racent.com/ssl/place

请求方式

POST

content-type

multipart/form-data

描述

此接口用于订购证书。

参数名称

参数类型

必填

说明

api_token

String

Y

身份凭据，生成token请联系锐成技术支持。

productCode

String

Y

产品编码，获取产品编码请参看获取产品和价格列表接口

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。

邮箱地址从以下5个任选其一。

[email protected]

administrator@ yourdomain.com

postmaster@ yourdomain.com

webmaster@ yourdomain.com

hostmaster@ yourdomain.com

        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

管理员所在城市。

email

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",

         "organization": "某公司"

}

job

String

N

财务员职位。

city

String

N

财务员所在城市。

email

String

N

财务员的邮箱。

state

String

N

财务员所在省或州。

mobile

String

N

财务员联系方式。

address

String

N

财务员联系地址。

country

String

N

财务员所在国家。

lastName

String

N

财务员姓。

postCode

String

N

财务员所在地邮编。

firstName

String

N

财务员名字。

    origination

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

技术员所在城市。

email

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证书号。