2.10 續訂SSL訂閱

2.10.1 API 資訊

測試環境
正式環境	https://portal.racent.com/ssl/renew
請求方式	POST
content-type	multipart/form-data
描述	此介面用於續訂SSL訂閱。只有狀態為已簽發且將於30天內過期的SSL訂閱，才允許被續訂。

2.10.2 參數定義

參數名稱	參數類型	必填	說明
api_token	String	Y	身分憑據，生成 token 請聯繫 Racent 技術支援。
renewId	String	Y	racent 證書 id
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	是	訂購資訊，具體說明如下
csr	String	否	當參數為空時，系統將為你產生 CSR，並儲存私鑰。
privateKey	String	否	私鑰。
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。
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。 CFCA 此項為 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	網域控制權驗證（DCV）方式。 必須為以下四種方式之一： EMAIL(郵箱驗證) HTTP_CSR_HASH(文件驗證) CNAME_CSR_HASH(DNS驗證) HTTPS_CSR_HASH(https文件驗證)
dcvEmail	String	N	網域控制權驗證（DCV）郵箱。當驗證方式為EMAIL時，此項為Y。
domainName	String	N	網域名稱
organizationInfo	String	N	公司資訊。當訂購需企業驗證類產品時，此參數為 Y。 CFCA 此項為 N。 範例如下： { "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	公司所在地郵遞區號。
Administrator	String	Y	管理員資訊、聯絡人。申請程式碼簽章、郵件簽章、文件簽章時，此參數作為申請資訊。另外如 csr 為 N，該資訊作為 csr 的生成資訊。 CFCA 此項為 N。 { "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	是	管理員所在省或州。
mobile	String	是	管理員聯絡方式。
address	String	是	管理員聯絡地址。
country	String	Y	管理員所在國家（ISO 3166-1 標準中的雙字母代碼）。
lastName	String	Y	管理員姓氏。
postCode	String	Y	管理員所在地郵遞區號。
firstName	String	Y	管理員姓名。
organation	String	Y	管理員公司名稱。
finance	String		僅與 SSL 憑證相關。 財務人員資訊。可與管理員資訊一致。當訂購產品非 dv 類型時，此參數為 Y。 CFCA 此項為 N。 { "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	財務員所屬公司。
tech	String	N	僅與 SSL 憑證相關。 技術員資訊。當訂購產品非 dv 類型時，此參數為 Y。 CFCA 此項為 N。 { "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	技術員所屬公司。

函式回傳

參數名稱	參數型態	必填	說明
code	Int	Y	回傳狀態，具體詳解請參見附錄3.1
errors	Object or String	N	當回傳狀態為錯誤時，具體的錯誤資訊。
data	Object	N	當回傳狀態為成功時，此參數為Y。具體描述如下：
certId	String	N	racent憑證id。請妥善保管，此參數為racent實例唯一憑據。
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	檔案驗證檔案路徑