2.10 Gia hạn đăng ký SSL
2.10.1 Thông tin API
| Môi trường kiểm thử | |
|---|---|
| Môi trường thực tế | https://portal.racent.com/ssl/renew |
| Phương thức yêu cầu | POST |
| content-type | multipart/form-data |
| Mô tả | Giao diện này được sử dụng để gia hạn đăng ký SSL. Chỉ những đăng ký SSL có trạng thái đã phát hành và sẽ hết hạn trong vòng 30 ngày mới được phép gia hạn. |
2.10.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. |
| renewId | String | Y | ID chứng chỉ racent |
| years | Int | Y | Số năm gia hạn (hiện chỉ hỗ trợ 1, 2, 3, 4, 5), tùy theo sản phẩm cụ thể. |
| refId | String | N | Mã đơn hàng duy nhất do khách hàng cung cấp |
| verificationPic | File | N | Tài liệu xác minh dự phòng. Dùng để xác minh tổ chức, hỗ trợ định dạng .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, dung lượng không quá 2M. |
| domainVerificationPic | File | N | Khi phương thức xác minh tên miền là: VERIFY_DOCUMENT, mục này là Y. 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 đặt hàng, mô tả chi tiết như sau |
| csr | String | N | Khi tham số để trống, hệ thống sẽ tạo csr cho bạn và lưu khóa riêng. |
| privateKey | String | N | Khóa riêng. |
| server | String | N | Máy chủ. Chỉ liên quan đến chứng chỉ SSL. Tham số là Y đối với chứng chỉ SSL và N đối với các loại sản phẩm khác. Nếu không cần tham số này, vui lòng mặc định là “other”. |
| orgCheck | Int | N | Giá trị là 0 hoặc 1. Khi giá trị là 1, hệ thống sẽ truy xuất tất cả tổ chức trong tài khoản của bạn dựa trên thông tin tổ chức bạn đã gửi. Nếu tổ chức đã tồn tại, hệ thống sẽ sử dụng thông tin liên kết của tổ chức hiện có; nếu không tồn tại, chúng tôi sẽ lưu thành tổ chức mới. Khi giá trị là 0, thông tin tổ chức sẽ không được lưu. |
| duplicateOrgCheck | Int | N | Giá trị là 0 hoặc 1. Tham số này hiện chỉ liên quan đến chứng chỉ SSL Digicert. Dùng để xác định có tái sử dụng thông tin tổ chức và tên miền đã được xác minh trước đó hay không. Khi giá trị là 1, sẽ tái sử dụng. Khi giá trị là 0, sẽ tạo mới. Mặc định là 1. |
| uniqueValue | String | N | Chỉ liên quan đến sản phẩm Sectigo. 1-20 ký tự (a-z A-Z 0-9) dùng để nhà phân phối tự tạo giá trị xác minh. |
| dcvMethod | String | N | Cài đặt thống nhất phương thức xác minh tên miền đã đă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 tệp) CNAME_CSR_HASH(xác minh DNS) HTTPS_CSR_HASH(xác minh tệp https) VERIFY_DOCUMENT(chứng nhận chứng chỉ tên miền,chỉ hỗ trợ CFCA) Mục này của CFCA là Y |
| domainInfo | String | N | Thông tin tên miền, chỉ liên quan đến chứng chỉ SSL. Tham số của chứng chỉ SSL là Y, tham số của các loại khác là N. Mục này của CFCA là 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ả cụ thể như sau: |
| dcvMethod | String | N | 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 qua DNS) HTTPS_CSR_HASH(xác thực qua tệp https) |
| dcvEmail | String | N | Email xác thực tên miền. Khi phương thức xác thực là EMAIL, mục này là Y. |
| domainName | String | N | Tên miền |
| organizationInfo | String | N | Thông tin công ty. Khi đặt mua sản phẩm cần xác thực doanh nghiệp, tham số này là Y. Đối với CFCA, mục này là N. Ví dụ như sau: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }" |
| 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ở. |
| Administrator | String | Y | Thông tin quản trị viên, người liên hệ. Khi đăng ký chứng chỉ ký mã nguồn, ký email, ký tài liệu, tham số này được dùng làm thông tin đăng ký. Ngoài ra, nếu csr là N, thông tin này được dùng làm thông tin tạo csr. Đối với CFCA, mục này là N. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
| job | String | Y | Chức vụ của quản trị viên. |
| city | String | Y | Thành phố của quản trị viên. |
| String | Y | Email của quản trị viên. | |
| state | String | Y | Tỉnh hoặc bang nơi quản trị viên cư trú. |
| mobile | String | Y | Thông tin liên hệ của quản trị viên. |
| address | String | Y | Địa chỉ liên hệ của quản trị viên. |
| country | String | Y | Quốc gia của quản trị viên (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | Y | Họ của quản trị viên. |
| postCode | String | Y | Mã bưu chính nơi quản trị viên cư trú. |
| firstName | String | Y | Tên quản trị viên. |
| organation | String | Y | Tên công ty của quản trị viên. |
| finance | String | Chỉ liên quan đến chứng chỉ SSL. Thông tin nhân viên tài chính. Có thể giống với thông tin quản trị viên. Khi sản phẩm được đặt hàng không thuộc loại dv, tham số này là Y. CFCA là N cho mục này. { "job": "Phòng Tài chính", "city": "Thượng Hải", "email": "xx@yy.com", "state": "Thượng Hải", "mobile": "18111111111", "address": "Thượng Hải", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Một công ty" }" | |
| job | String | N | Chức vụ của nhân viên tài chính. |
| city | String | N | Thành phố nơi nhân viên tài chính đang làm việc. |
| String | N | Email của nhân viên tài chính. | |
| state | Chuỗi | N | Tỉnh hoặc bang nơi nhân viên tài chính cư trú. |
| mobile | Chuỗi | N | Thông tin liên hệ của nhân viên tài chính. |
| address | Chuỗi | N | Địa chỉ liên hệ của nhân viên tài chính. |
| country | String | N | Quốc gia nơi nhân viên tài chính cư trú (mã hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | N | Họ của nhân viên tài chính. |
| postCode | String | N | Mã bưu chính nơi nhân viên tài chính cư trú. |
| firstName | String | N | Tên nhân viên tài chính. |
| organation | String | N | Công ty của nhân viên tài chính. |
| tech | String | N | Chỉ liên quan đến chứng chỉ SSL. Thông tin kỹ thuật viên. Khi sản phẩm đặt hàng không thuộc loại dv, tham số này là Y. Đối với CFCA, mục này là N. { "job": "Phòng kỹ thuật","city": "Thượng Hải", "email": "xx@yy.com", "state": "Thượng Hải", "mobile": "18111111111", "address": "Thượng Hải", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Công ty XYZ" }" |
| job | String | N | Chức danh kỹ thuật viên. |
| city | String | N | Thành phố nơi kỹ thuật viên làm việc. |
| String | N | Email của kỹ thuật viên. | |
| state | String | N | Tỉnh hoặc bang nơi kỹ thuật viên sinh sống. |
| mobile | String | N | Thông tin liên hệ của kỹ thuật viên. |
| address | String | N | Địa chỉ liên hệ của kỹ thuật viên. |
| country | String | N | Quốc gia nơi kỹ thuật viên cư trú (mã gồm hai chữ cái theo tiêu chuẩn ISO 3166-1). |
| lastName | String | N | Họ của kỹ thuật viên. |
| postCode | String | N | Mã bưu chính nơi kỹ thuật viên cư trú. |
| firstName | String | N | Tên kỹ thuật viên. |
| organation | String | N | Công ty của kỹ thuật viên. |
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, đây là 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 bảo quản cẩn thận, đây là thông tin xác thực duy nhất của phiên bản racent. |
| vendorId | String | N | Mã đơ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 chứng chỉ đăng ký khác nhau, mục này là Y Mỗi mục có kiểu Object, tên đối tượng của mỗi mục 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 |