Thống kê hoạt động
Hướng dẫn nhanh
- 1. Quản lý Sản phẩm: Khai báo các phần mềm/công cụ tại tab Sản phẩm (ví dụ
zeno,retrohub...). - 2. Cấp Key Bản quyền: Tạo mã key cho từng sản phẩm tại tab Quản lý Key. Khách nhập key trên app sẽ tự động bind định danh máy tính (HWID).
- 3. Phát hành OTA: Đẩy phiên bản mới lên tab Phát hành OTA (hỗ trợ nhập link tải hoặc tải file trực tiếp). Ứng dụng Desktop sẽ tự động thông báo và cập nhật.
- 4. Tích hợp Bot / Web bán hàng: Dùng mã
X-Admin-Tokentại tab Cấu hình để tạo key tự động không cần mở web.
Quản lý Sản phẩm
Danh sách các phần mềm hoặc ứng dụng quản lý bản quyền và OTA trên hệ thống.
| Mã Code (Slug) | Tên sản phẩm | Mô tả | Số License đã cấp | Trạng thái | Ngày tạo | Thao tác |
|---|---|---|---|---|---|---|
| Đang tải danh sách sản phẩm... | ||||||
Danh sách Mã Bản quyền (Licenses)
Quản lý key, khách hàng sở hữu và thiết bị đã kích hoạt.
| Mã Key | Sản phẩm | Khách hàng | Gói cước | Máy kích hoạt | Thời hạn | Trạng thái | Thao tác |
|---|---|---|---|---|---|---|---|
| Đang tải dữ liệu... | |||||||
Bản phát hành & Cập nhật OTA
Quản lý các bản build ứng dụng để Desktop App tự động kiểm tra và nâng cấp.
| Sản phẩm | Phiên bản | Nền tảng | Tên file / Link tải | Dung lượng | SHA256 | Loại cập nhật | Lượt tải | Ngày đăng | Thao tác |
|---|---|---|---|---|---|---|---|---|---|
| Đang tải dữ liệu phát hành... | |||||||||
Cấu hình Hệ thống & API Token
Mã bảo mật Admin API Token
Token này dùng trong Header X-Admin-Token cho bot Telegram/Discord hoặc Web bán hàng tự động tạo key mà không cần đăng nhập. Bạn có thể thay đổi token bất cứ lúc nào:
Endpoint Máy chủ
API Base URL: https://key.xuanhoa493.com
Tài liệu Tích hợp API (Developer Docs)
Hướng dẫn chi tiết tích hợp dịch vụ Bản quyền và OTA Update vào ứng dụng Desktop hoặc Bot bán hàng.
Ứng dụng Client gọi API này khi người dùng nhập key lần đầu để kích hoạt và gán với Hardware ID của máy.
// Request Body (JSON)
{
"key": "ZENO-XXXX-YYYY-ZZZZ",
"hwid": "ZENO-80A39DE2-C83619E2",
"hostname": "MacBook-Pro",
"os_info": "macOS 15.0 darwin-arm64",
"app_version": "1.0.0"
}
// Response thành công (HTTP 200)
{
"ok": true,
"data": {
"valid": true,
"key_code": "ZENO-XXXX-YYYY-ZZZZ",
"customer_name": "Nguyễn Văn A",
"plan_type": "1_month",
"days_left": 30,
"max_devices": 1,
"device_count": 1,
"hwid": "ZENO-80A39DE2-C83619E2"
}
}Ứng dụng Client gọi API này mỗi khi khởi động để xác minh xem key còn hạn và có đúng máy hay không.
// Request Body (JSON)
{
"key": "ZENO-XXXX-YYYY-ZZZZ",
"hwid": "ZENO-80A39DE2-C83619E2",
"app_version": "1.0.0"
}
// Response (HTTP 200)
{
"ok": true,
"data": {
"valid": true,
"days_left": 28,
"message": "Bản quyền hợp lệ"
}
}Ứng dụng Client kiểm tra xem máy chủ có phiên bản mới hơn phiên bản đang chạy hay không.
Ví dụ: https://key.xuanhoa493.com/api/v1/update/check?product=zeno&platform=windows-amd64&version=1.0.0
// Response (HTTP 200)
{
"has_update": true,
"product_code": "zeno",
"current_version": "1.0.0",
"latest_version": "1.0.1",
"download_url": "https://key.xuanhoa493.com/uploads/zeno-1.0.1-windows-amd64.exe",
"file_name": "zeno-1.0.1-windows-amd64.exe",
"file_size": 15420310,
"sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"changelog": "- Thêm tính năng tự động thanh toán\n- Sửa lỗi hiển thị UI\n- Cải thiện tốc độ xử lý",
"is_force_update": false
}Dùng cho Bot Telegram/Discord hoặc Web bán hàng tự động sinh mã bản quyền sau khi khách thanh toán thành công.
// Header
X-Admin-Token: [MÃ_TOKEN_TRONG_TAB_CẤU_HÌNH]
Content-Type: application/json
// Request Body
{
"product_code": "zeno",
"customer_name": "Khách hàng VIP 01",
"customer_contact": "0987654321 / @telegram",
"plan_type": "1_month", // 1_month, 3_months, 6_months, 1_year, lifetime
"duration_days": 30,
"max_devices": 1,
"count": 1,
"notes": "Đơn hàng #9982 qua Webhook"
}
// Response
{
"success": true,
"message": "Tạo key thành công!",
"data": [
{
"id": 12,
"key_code": "ZENO-99AB-CD88-EF12",
"customer_name": "Khách hàng VIP 01",
"plan_type": "1_month",
"status": "active"
}
]
}