測試環(huán)境

真實環(huán)境

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

請求方式

POST

content-type

multipart/form-data

描述

此接口用于訂購證書。

參數(shù)名稱

參數(shù)類型

必填

說明

api_token

String

Y

身份憑據(jù)，生成token請聯(lián)系銳成技術支持。

productCode

String

Y

產(chǎn)品編碼，獲取產(chǎn)品編碼請參看獲取產(chǎn)品和價格列表接口

years

Int

Y

購買年限（目前只支持1，2，3，4，5，6），根據(jù)具體產(chǎn)品而定。

refId

String

N

客戶提供的唯一客戶訂單號

params

Json

Y

訂購信息，具體描述如下

csr

String

N

當參數(shù)為空時，會為你生成csr，并保存私鑰。

privateKey

String

N

私鑰。

server

String

N

服務器。僅與SSL證書相關。SSL證書參數(shù)為Y，其他類型產(chǎn)品參數(shù)為N。若不需要此參數(shù)，請默認“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產(chǎn)品相關。1-20個字符（a-z A-Z 0-9）用于分銷商自主生成驗證值。

domainInfo

Json 數(shù)組

N

域名信息，僅與SSL證書相關。SSL證書參數(shù)為Y，其他類型參數(shù)為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è)驗證類產(chǎn)品，此參數(shù)為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

管理員信息、聯(lián)系人。當申請代碼簽名、郵件簽名、文檔簽名時，此參數(shù)作為申請信息。另外如csr為N，該信息作為csr的生成信息。

{

"job": "總經(jīng)辦",

         "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

管理員聯(lián)系方式。

address

String

Y

管理員聯(lián)系地址。

country

String

Y

管理員所在國家。國家代碼請見附錄。

lastName

String

Y

管理員姓。

postCode

String

Y

管理員所在地郵編。

firstName

String

Y

管理員名字。

organization

String

Y

管理員公司名稱。

finance

Json

僅與SSL證書相關。

財務人員信息?？梢耘c管理員信息一致。當訂購產(chǎn)品非dv類型時，此參數(shù)為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

財務員聯(lián)系方式。

address

String

N

財務員聯(lián)系地址。

country

String

N

財務員所在國家。

lastName

String

N

財務員姓。

postCode

String

N

財務員所在地郵編。

firstName

String

N

財務員名字。

    origination

String

N

財務員所在公司。

tech

Json

N

僅與SSL證書相關。

技術員信息。當訂購產(chǎn)品非dv類型時，此參數(shù)為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

技術員聯(lián)系方式。

address

String

N

技術員聯(lián)系地址。

country

String

N

技術員所在國家。

lastName

String

N

技術員姓。

postCode

String

N

技術員所在地郵編。

firstName

String

N

技術員名字。

    organization

String

N

技術員所在公司。

函數(shù)返回

code

Int

Y

返回狀態(tài)，具體請見附錄響應代碼。

errors

Array or String

N

當返回狀態(tài)為錯誤時，具體錯誤信息。

data

Json

N

當返回狀態(tài)為成功時，此參數(shù)為Y。具體描述如下：

  certId

String

N

racent證書id。請妥善保管，此參數(shù)為racent實例唯一憑據(jù)。

  vendorId

String

N

CA訂單號。

vendorCertId

String

N

CA證書號。