2.2 訂購證書

2.2.1 介面說明

測試環境
真實環境	https://portal.racent.com/ssl/place
請求方式	POST
content-type	multipart/form-data
描述	此介面用於訂購證書。

2.2.2 參數定義

參數名稱	參數類型	必填	說明
api_token	String	Y	身份憑據，生成 token 請聯絡 Racent 技術支援。
productCode	String	Y	產品編碼，取得產品編碼（見2.7）
years	Int	Y	購買年限（目前僅支援1、2、3、4、5），依具體產品而定。
refId	String	N	客戶提供的唯一客戶訂單編號
verificationPic	File	N	備用驗證材料。用於組織驗證，支援 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf 格式，內容大小不超過 2M。
domainVerificationPic	File	N	當網域驗證方式為：VERIFY_DOCUMENT 時，此項為 Y。用於網域控制權驗證（DCV）（目前僅支援 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。
needFree	Int	N	值為 1 或 2。當值為 1 時，將贈送 FQDN，同時 www.domain 也將贈送 domain。值為 2 時，不贈送。
uniqueValue	String	N	僅與 Sectigo 產品相關。1-20 個字元（a-z A-Z 0-9），供經銷商自行產生驗證值使用。
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	管理員所在城市。
email	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。
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	財務員所在城市。
email	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	技術員所在城市。
email	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實例唯一憑據。
failReason	Object	N	當銳成向CA申請證書失敗，並能明確了失敗原因，會回傳此項。
dataReasons	Array	N	資料原因
key	String	N	項目
reason	String	N	原因
sysReason	String	N	系統原因
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	檔案驗證檔案路徑