Tên miền website
Kiểm tra tên miền
Kiểm tra ngay bản ghi DNS và chứng chỉ SSL của một tên miền riêng
Chỉ có trên Hubport SaaS
Trên bản cài đặt riêng (máy chủ riêng), endpoint trả HTTP 404 error_saas_mode_inactive.
Endpoint
POST /v1/platformdomains/{id}/check
Yêu cầu quyền company.setting và tính năng custom_domain. Kiểm ngay bản ghi TXT, CNAME/A, tên miền gốc, CAA và chứng chỉ SSL,
cập nhật trạng thái (như nút Kiểm tra ngay trong app). Hệ thống vẫn tự kiểm định kỳ, không cần gọi liên tục: mỗi tên miền chỉ
kiểm được một lần mỗi 10 giây.
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID tên miền (Domain Object) |
Không có request body.
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
item | object | Domain Object sau khi kiểm |
overview | object | Dữ liệu như Website của cửa hàng |
Đọc item.status, item.last_error, item.warnings và item.dns.records[].ok để biết bước tiếp theo. Ý nghĩa: Tên miền con & tên miền riêng.
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 402 | error_feature_requires_plan | Gói không có tính năng tên miền riêng. detail.feature = "custom_domain" |
| 403 | error_role_not_available | Người dùng không có quyền company.setting |
| 403 | error_impersonation_readonly | Phiên hỗ trợ của Hubport chỉ được xem |
| 404 | error_domain_not_found | Không có tên miền này trong cửa hàng |
| 404 | error_saas_mode_inactive | Không phải Hubport SaaS |
| 429 | error_domain_check_too_frequent | Vừa kiểm xong. detail.retry_after là số giây chờ (10) |
Ví dụ
curl -X POST "https://api.hubport.vn/v1/platformdomains/1003/check" \
-H "Authorization: <JWT>"{
"item": {
"id": 1003,
"domain": "www.shopcuatoi.vn",
"status": "ssl_pending",
"verified": true,
"txt_ok": true,
"routing_ok": true,
"apex_ok": true,
"tls_ok": false,
"warnings": [],
"last_error": "tls_cert_invalid"
},
"overview": {
"company_id": 12,
"primary_url": "https://tencuahang.hubport.com.vn"
}
}(Ví dụ rút gọn, response đầy đủ có mọi trường của Domain Object.)
{
"error": ["error_domain_check_too_frequent"],
"detail": {
"retry_after": 10
}
}