Gói dịch vụ & thanh toán
Khôi phục cửa hàng
Chủ cửa hàng tự khôi phục cửa hàng đang bị tạm khoá (xoá mềm) do không hoạt động hoặc do quá hạn thanh toán
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/platformrestores
Chỉ chủ cửa hàng được gọi. Dùng được cả khi cửa hàng bị khoá. Cửa hàng chỉ khôi phục được khi đang bị xoá mềm và chưa bị xoá vĩnh viễn (trường restorable của Trạng thái khôi phục cửa hàng).
Request Body
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
nonce | string | Không | Chuỗi ngẫu nhiên khác nhau cho mỗi lần gọi, tránh bị chặn bởi cơ chế chống gửi trùng (HTTP 409 error_idempotent_check_duplicate_found) |
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
result | string | Luôn là restored |
company_id | int | ID công ty |
restorable | bool | Sau khi khôi phục thành công là false |
state | string | Trạng thái cửa hàng sau khi khôi phục (vd trial, free...) |
cleanup_stage | string | active |
soft_deleted_at | int | 0 |
hard_delete_due_at | int | 0 |
is_owner | bool | true |
Workflow & Logic
- Kiểm người gọi là chủ cửa hàng.
- Kiểm cửa hàng đang ở giai đoạn
soft_deletedhoặchard_delete_due. - Đưa cửa hàng về
active, đặt lại bộ đếm thời gian không hoạt động, mở lại storefront. Cửa hàng dùng lại được ngay theo gói / trạng thái hiện có (cửa hàng bị khoá do gói trả phí quá hạn thanh toán mở lại với gói miễn phí; thanh toán hoá đơn gia hạn thì cửa hàng tự mở khoá kèm gói, không cần gọi endpoint này).
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 403 | error_company_owner_required | Người gọi không phải chủ cửa hàng |
| 403 | error_company_required | Phiên đăng nhập không gắn với công ty nào |
| 404 | error_not_found | Không tìm thấy công ty |
| 404 | error_saas_mode_inactive | Không phải Hubport SaaS |
| 422 | error_company_not_restorable | Cửa hàng không ở trạng thái xoá mềm (hoặc đã bị xoá vĩnh viễn) |
| 422 | error_hard_delete_requested | Cửa hàng đã có yêu cầu xoá vĩnh viễn đang chờ thực hiện, không tự khôi phục được. Vui lòng liên hệ Hubport |
| 422 | error_hard_delete_in_progress | Dữ liệu cửa hàng đang được xoá vĩnh viễn, không khôi phục được |
| 422 | error_company_hard_deleted | Cửa hàng đã bị xoá vĩnh viễn |
| 422 | error_restore_failed | Khôi phục không thành công, vui lòng thử lại hoặc liên hệ Hubport |
Ví dụ
curl -X POST "https://api.hubport.vn/v1/platformrestores" \
-H "Authorization: <JWT>" \
-H "Content-Type: application/json" \
-d '{"nonce":"1760317200123"}'{
"result": "restored",
"company_id": 12,
"restorable": false,
"state": "free",
"cleanup_stage": "active",
"soft_deleted_at": 0,
"hard_delete_due_at": 0,
"is_owner": true
}