2.12 替換SSL訂閱資訊
2.12.1 Api 資訊
| 測試環境 | |
|---|---|
| 正式環境 | https://portal.racent.com/ssl/replace |
| 請求方式 | POST |
| content-type | multipart/form-data |
| 描述 | 此介面用於替換 SSL 訂閱資訊。僅與 SSL 證書相關。只有當 SSL 訂閱狀態為已簽發，才允許替換 SSL 訂閱資訊。 |
2.12.2 參數定義
| 參數名稱 | 參數類型 | 必填 | 說明 |
|---|---|---|---|
| api_token | String | Y | 身份憑據，產生 token 請聯繫 Racent 技術支援。 |
| certId | String | Y | racent 證書 id |
| refId | String | N | 客戶提供的唯一客戶訂單號 |
| domainVerificationPic | File | N | 當網域驗證方式為：VERIFY_DOCUMENT，此項為 Y。用於網域控制權驗證（DCV）（目前僅支援 CFCA）。 |
| params | String | Y | 替換資訊，具體說明如下 |
| csr | String | Y | 註：CSR 資訊中的網域必須與原 SSL 訂閱中 CSR 的網域保持一致。 |
| 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 | Y | 網域資訊。 範例： [ { "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 | Y | 網域控制權驗證（DCV）方式。 必須為以下四種方式之一： 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 | Y | 網域名稱 |
| organizationInfo | String | N | 當你需要變更公司資訊時，此參數為Y。 |
| organizationCity | String | N | 公司所在城市。 |
| organizationName | String | N | 公司名稱。 |
| organizationMobile | String | N | 公司電話。 |
| organizationAddress | String | N | 公司地址。 |
| organizationCountry | String | N | 公司所在國家（ISO 3166-1 標準中的雙字母代碼）。 |
| organizationPostCode | 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 | 檔案驗證檔案路徑 |