2.1 Xác thực dữ liệu
2.1.1 Mô tả giao diện
| Môi trường kiểm thử | |
|---|---|
| Môi trường thực tế | https://portal.racent.com/ssl/validate |
| Phương thức yêu cầu | POST |
| content-type | multipart/form-data |
| Mô tả | Giao diện này dùng để xác thực tất cả dữ liệu đặt hàng bạn truyền vào. Vui lòng gọi giao diện này trước khi gọi giao diện đặt hàng để đảm bảo quá trình xử lý đơn hàng diễn ra suôn sẻ. Việc xác thực này dùng để xác nhận thông tin tài khoản của bạn, đồng thời đảm bảo thông tin đặt hàng của bạn chính xác, trả về mã lỗi tương ứng (xem Phụ lục 3.1). |
2.1.2 Định nghĩa tham số
| Tên tham số | Kiểu tham số | Bắt buộc | Mô tả |
|---|---|---|---|
| api_token | String | Y | Token người dùng, để lấy token vui lòng liên hệ hỗ trợ kỹ thuật Racent |
| productCode | String | Y | Mã sản phẩm, để lấy mã sản phẩm (xem 2.7) |
| years | Int | Y | Số năm mua (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. Được 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 (chuỗi json), 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. Khi tham số chứng chỉ SSL là Y, các loại sản phẩm khác là N. Nếu không cần tham số này, vui lòng đặt mặc định là “other”. |
| 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 | Thống nhất thiết lập 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 minh chứng chỉ tên miền, chỉ hỗ trợ CFCA) Đối với CFCA, mục này là Y |
| domainInfo | String | N | Thông tin tên miền, chỉ liên quan đến chứng chỉ SSL. Tham số chứng chỉ SSL là Y, tham số loại khác 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 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 minh 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 | N | Tên miền |
| organizationInfo | String | N | Thông tin công ty. Khi đặt mua sản phẩm yêu cầu xác minh doanh nghiệp, tham số này là Y. 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 chuẩn ISO 3166-1). |
| organizationPostCode | String | N | Mã bưu chính nơi công ty đặt trụ sở. |
| organizationRegNumber | String | N | Số chứng nhận công ty. Đối với CFCA, mục này là Y. |
| idType | String | N | Loại giấy tờ công ty. Đối với CFCA, mục này là Y. Các giá trị như sau: TYDMZ: Mã thống nhất tín dụng xã hội OTHERS: Khác |
| Administrator | string | Y | Thông tin quản trị viên, người liên hệ. Khi đăng ký chữ ký mã, chữ ký email, chữ 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. { "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ố nơi quản trị viên cư trú. |
| String | Y | Email của quản trị viên. | |
| state | String | Y | Tỉnh hoặc tiểu 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ã gồ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. |
| idType | String | N | Loại giấy tờ. Đối với CFCA, mục này là Y. Các giá trị như sau: SFZ: Chứng minh nhân dân HZ: Hộ chiếu |
| idNumber | String | N | Số chứng từ. Đối với CFCA, mục này là Y. |
| finance | string | Chỉ liên quan đến chứng chỉ SSL. Thông tin nhân viên tài chính. Có thể trùng với thông tin quản trị viên. Khi sản phẩm đặt mua không thuộc loại dv, tham số này là 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": "Công ty XYZ" }" | |
| 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 làm việc. |
| String | N | Email của nhân viên tài chính. | |
| state | String | N | Tỉnh hoặc bang nơi nhân viên tài chính cư trú. |
| mobile | String | N | Thông tin liên hệ của nhân viên tài chính. |
| address | String | 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 nơi nhân viên tài chính làm việc. |
| idType | String | N | Loại giấy tờ. Mục này là Y đối với CFCA. Các giá trị như sau: SFZ：Chứng minh nhân dân HZ：Hộ chiếu |
| idNumber | String | N | Số chứng minh nhân dân. Đối với CFCA, mục này là Y. |
| 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 được đặt hàng không thuộc loại dv, tham số này là Y. { "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 vụ của kỹ thuật viên. |
| city | String | N | Thành phố nơi kỹ thuật viên cư trú. |
| 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 cư trú. |
| 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 của kỹ thuật viên (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 của kỹ thuật viên. |
| organation | String | N | Công ty của kỹ thuật viên. |
| idType | String | N | Loại giấy tờ. CFCA mục này là Y. Giá trị như sau: SFZ: CMND HZ: Hộ chiếu |
| idNumber | String | N | Số giấy tờ. CFCA mục này là Y. |
Hàm trả về
| 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. |
2.1.3 Ví dụ yêu cầu
请求示例
{
"years": 2,
"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
"api_token": "zzzoooppzz",
"productCode": "comodo-positivessl"
}