2.12 Thay thế thông tin đăng ký SSL
2.12.1 Thông tin API
| Môi trường kiểm thử | |
|---|---|
| Môi trường thực tế | https://portal.racent.com/ssl/replace |
| Phương thức yêu cầu | POST |
| content-type | multipart/form-data |
| Mô tả | API này dùng để thay thế thông tin đăng ký SSL. Chỉ liên quan đến chứng chỉ SSL. Chỉ khi trạng thái đăng ký SSL là đã phát hành thì mới cho phép thay thế thông tin đăng ký SSL. |
2.12.2 Định nghĩa tham số
| Tên tham số | Kiểu tham số | Bắt buộc | Mô tả |
|---|---|---|---|
| api_token | String | Y | Thông tin xác thực, để tạo token vui lòng liên hệ hỗ trợ kỹ thuật Racent. |
| certId | String | Y | id chứng chỉ racent |
| refId | String | N | Mã đơn hàng duy nhất do khách hàng cung cấp |
| domainVerificationPic | File | N | Khi phương thức xác minh tên miền là: VERIFY_DOCUMENT, mục này là Y. Được sử dụng để xác minh quyền sở hữu tên miền (hiện chỉ hỗ trợ CFCA). |
| params | String | Y | Thông tin thay thế, mô tả cụ thể như sau |
| csr | String | Y | Lưu ý: Tên miền trong thông tin CSR phải nhất quán với tên miền trong CSR của gói SSL gốc. |
| uniqueValue | String | N | Chỉ liên quan đến sản phẩm Sectigo. 1-20 ký tự (a-z A-Z 0-9) được dùng để nhà phân phối tự tạo giá trị xác minh. |
| dcvMethod | String | N | Thiết lập thống nhất phương thức xác minh tên miền khi đăng ký. Phải là một trong bốn phương thức sau: EMAIL (xác minh qua email) HTTP_CSR_HASH (xác minh qua tệp) CNAME_CSR_HASH (xác minh DNS) HTTPS_CSR_HASH (xác minh tệp https) VERIFY_DOCUMENT (chứng nhận tên miền, chỉ hỗ trợ CFCA) Mục này là Y đối với CFCA |
| domainInfo | String | Y | Thông tin tên miền. Ví dụ: [ { "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" } ] Mô tả chi tiết như sau: |
| dcvMethod | String | Y | Phương thức xác thực tên miền. Phải là một trong bốn phương thức sau: EMAIL(xác thực qua email) HTTP_CSR_HASH(xác thực qua tệp) CNAME_CSR_HASH(xác thực DNS) HTTPS_CSR_HASH(xác thực tệp https) Khi dcvMethod cấp trên không tồn tại, mục này là Y. Khi dcvMethod cấp trên tồn tại và mục này cũng tồn tại, sẽ ưu tiên sử dụng dcvMethod cấp trên. |
| dcvEmail | String | N | Email xác thực tên miền. Khi mục này là N, trường hợp mặc định như sau racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | Y | Tên miền |
| organizationInfo | String | N | Khi bạn cần thay đổi thông tin công ty, tham số này là Y. |
| organizationCity | String | N | Thành phố nơi công ty đặt trụ sở. |
| organizationName | String | N | Tên công ty. |
| organizationMobile | String | N | Số điện thoại công ty. |
| organizationAddress | String | N | Địa chỉ công ty. |
| organizationCountry | String | N | Quốc gia nơi công ty đặt trụ sở (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| organizationPostCode | String | N | Mã bưu chính nơi công ty đặt trụ sở. |
Giá trị trả về của hàm
| Tên tham số | Kiểu tham số | Bắt buộc | Mô tả |
|---|---|---|---|
| code | Int | Y | Trạng thái trả về, chi tiết xem Phụ lục 3.1 |
| errors | Object or String | N | Khi trạng thái trả về là lỗi, thông tin lỗi cụ thể. |
| data | Object | N | Khi trạng thái trả về là thành công, tham số này là Y. Mô tả cụ thể như sau: |
| certId | String | N | ID chứng chỉ racent. Vui lòng lưu giữ cẩn thận, tham số này là thông tin xác thực duy nhất của phiên bản racent. |
| vendorId | String | N | Số đơn hàng CA. |
| vendorCertId | String | N | Số chứng chỉ CA. |
| DCVfileName | String | N | Tên tệp xác thực tệp |
| DCVfileContent | String | N | Nội dung tệp xác thực tệp |
| DCVdnsHost | String | N | Giá trị máy chủ xác thực DNS |
| DCVdnsValue | String | N | Giá trị bản ghi xác thực DNS |
| DCVdnsType | String | N | Loại bản ghi xác thực DNS |
| DCVfilePath | String | N | Đường dẫn tệp xác thực tệp |
| dcvInfo | Object | N | Khi giá trị xác thực của từng tên miền trong đơn đăng ký chứng chỉ khác nhau, mục này là Y Mỗi mục có kiểu là Object, tên mỗi đối tượng là tên miền đã đăng ký, ví dụ: racent.com. Chi tiết từng mục như sau: |
| DCVfileName | String | N | Nội dung tệp xác thực tệp |
| DCVfileContent | String | N | Nội dung tệp xác thực tệp |
| DCVdnsHost | String | N | Giá trị máy chủ xác thực Dns |
| DCVdnsValue | String | N | Giá trị bản ghi xác thực Dns |
| DCVdnsType | String | N | Loại bản ghi xác thực Dns |
| DCVfilePath | String | N | Đường dẫn tệp xác thực tệp |