Tài liệu API VPS

Hướng dẫn tích hợp API quản lý VPS và dịch vụ cloud

Trang chủ Lấy Token

Thông tin chung về API

Endpoint:

https://web.ducyuz.com/api/v19

Phương thức HTTP:POST

Content-Type:application/x-www-form-urlencoded

Định dạng phản hồi:JSON

Xác thực Authorization:

Authorization: Bearer {auth_token}

auth_token={token}

Lấy auth_token tại trang profile

🔒 Cảnh báo bảo mật

• auth_token là chìa khóa truy cập tài khoản - vui lòng bảo mật tuyệt đối
• Không chia sẻ auth_token với bất kỳ ai, kể cả nhân viên hỗ trợ
• Thay đổi auth_token thường xuyên để tăng cường bảo mật
• Nếu nghi ngờ bị lộ, hãy thay đổi ngay lập tức
• Thông tin VPS và tài khoản chỉ hiển thị cho chủ tài khoản

API Endpoints

Danh sách dịch vụ

Lấy danh sách các gói VPS khả dụng.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `services`

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Danh sách gói VPS khả dụng",
    "data": [
        {
            "id": "1",
            "name": "PLATINUM SEGAY",
            "price": {
                "monthly": {
                    "amount": 65000
                },
                "quarterly": {
                    "amount": 185000
                },
                "yearly": {
                    "amount": 725000
                }
            },
            "specs": {
                "cpu": 2,
                "ram": 2,
                "disk": 30,
                "ip": "1 IPv4 Riêng",
                "os": "Windows/Linux",
                "bandwidth": "Không giới hạn"
            }
        },
        {
            "id": "2",
            "name": "Mini Cloud",
            "price": {
                "monthly": {
                    "amount": 50000
                },
                "quarterly": {
                    "amount": 0
                },
                "yearly": {
                    "amount": 0
                }
            },
            "specs": {
                "cpu": 1,
                "ram": 2,
                "disk": 20,
                "ip": "1 IPv4 Riêng",
                "os": "Windows/ linux",
                "bandwidth": "Không giới hạn"
            }
        }
    ]
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Cloud Vps Không Có"
}

Danh sách hệ điều hành

Lấy danh sách các hệ điều hành khả dụng cho VPS.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `os`

Phản hồi JSON mẫu

{
    "error": 0,
    "os-vps": [
        {
            "os-id": 1,
            "os-name": "Windows Server 2012 R2"
        },
        {
            "os-id": 2,
            "os-name": "Windows Server 2016"
        },
        {
            "os-id": 3,
            "os-name": "Linux CentOS 7 64bit"
        },
        {
            "os-id": 4,
            "os-name": "Windows Server 2019"
        },
        {
            "os-id": 5,
            "os-name": "Windows 10 64bit"
        },
        {
            "os-id": 6,
            "os-name": "Linux Ubuntu-20.04"
        },
        {
            "os-id": 7,
            "os-name": "Linux Ubuntu-22.04"
        },
        {
            "os-id": 9,
            "os-name": "AlmaLinux 8"
        },
        {
            "os-id": 10,
            "os-name": "Debian 12"
        }
    ]
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "auth_token không hợp lệ hoặc tài khoản bị khóa"
}

Danh sách Addons

Lấy danh sách các addon VPS khả dụng để nâng cấp cấu hình.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `addons`

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Danh sách addon VPS khả dụng",
    "data": [
        {
            "id": "16",
            "product_id": "58",
            "name": "Mua thêm CPU",
            "type_addon": "addon_cpu",
            "price": {
                "product_id": 58,
                "name": "Mua thêm CPU",
                "cpu": 1,
                "ram": 0,
                "disk": 0,
                "type_addon": "addon_cpu",
                "pricing": {
                    "monthly": {
                        "billing_cycle": "1 Tháng",
                        "amount": "45000"
                    },
                    "twomonthly": {
                        "billing_cycle": "2 Tháng",
                        "amount": "60000"
                    },
                    "quarterly": {
                        "billing_cycle": "3 Tháng",
                        "amount": "90000"
                    },
                    "semi_annually": {
                        "billing_cycle": "6 Tháng",
                        "amount": "180000"
                    },
                    "annually": {
                        "billing_cycle": "1 Năm",
                        "amount": "360000"
                    },
                    "biennially": {
                        "billing_cycle": "2 Năm",
                        "amount": "720000"
                    },
                    "triennially": {
                        "billing_cycle": "3 Năm",
                        "amount": "1080000"
                    }
                }
            }
        },
        {
            "id": "17",
            "product_id": "59",
            "name": "Mua thêm RAM",
            "type_addon": "addon_ram",
            "price": {
                "product_id": 59,
                "name": "Mua thêm RAM",
                "cpu": 0,
                "ram": 1,
                "disk": 0,
                "type_addon": "addon_ram",
                "pricing": {
                    "monthly": {
                        "billing_cycle": "1 Tháng",
                        "amount": 20000
                    },
                    "twomonthly": {
                        "billing_cycle": "2 Tháng",
                        "amount": 40000
                    },
                    "quarterly": {
                        "billing_cycle": "3 Tháng",
                        "amount": 60000
                    },
                    "semi_annually": {
                        "billing_cycle": "6 Tháng",
                        "amount": 120000
                    },
                    "annually": {
                        "billing_cycle": "1 Năm",
                        "amount": 240000
                    },
                    "biennially": {
                        "billing_cycle": "2 Năm",
                        "amount": 480000
                    },
                    "triennially": {
                        "billing_cycle": "3 Năm",
                        "amount": 720000
                    }
                }
            }
        },
        {
            "id": "18",
            "product_id": "60",
            "name": "Mua thêm DISK",
            "type_addon": "addon_disk",
            "price": {
                "product_id": 60,
                "name": "Mua thêm DISK",
                "cpu": 0,
                "ram": 0,
                "disk": 10,
                "type_addon": "addon_disk",
                "pricing": {
                    "monthly": {
                        "billing_cycle": "1 Tháng",
                        "amount": "20000"
                    },
                    "twomonthly": {
                        "billing_cycle": "2 Tháng",
                        "amount": "24000"
                    },
                    "quarterly": {
                        "billing_cycle": "3 Tháng",
                        "amount": "36000"
                    },
                    "semi_annually": {
                        "billing_cycle": "6 Tháng",
                        "amount": "72000"
                    },
                    "annually": {
                        "billing_cycle": "1 Năm",
                        "amount": "144000"
                    },
                    "biennially": {
                        "billing_cycle": "2 Năm",
                        "amount": "288000"
                    },
                    "triennially": {
                        "billing_cycle": "3 Năm",
                        "amount": "432000"
                    }
                }
            }
        }
    ]
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Không có addon VPS nào"
}

⚠️ Lưu ý bảo mật

Vui lòng bảo mật tuyệt đối auth_token và thay đổi thường xuyên để tránh bị lộ thông tin tài khoản.

Danh sách VPS của bạn

Lấy danh sách tất cả VPS mà người dùng đã mua, dựa trên auth_token.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `listvps`

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Danh sách VPS của bạn",
    "data": [
        {
            "id": "2",
            "vps_id": "2138",
            "billingcycle": "monthly",
            "billingcycleday": "31",
            "status": "delete_vps",
            "price": "50000",
            "cost": "45000",
            "total_price": "50000",
            "total_cost": "45000",
            "created_at": "2025-08-01 15:14:42",
            "updated_at": "2025-08-01 15:14:42",
            "info": {
                "vps-id": 2138,
                "ip": "160.250.247.238",
                "cpu": 1,
                "ram": 2,
                "disk": 20,
                "text-config": "1 CPU - 2 RAM - 20 Disk",
                "date_create": "01-08-2025",
                "next_due_date_vps": "2025-09-01",
                "next_due_date": "01-09-2025",
                "billing-cycle": "1 Tháng",
                "day-left": "Còn hạn 17 ngày",
                "vps-status": "delete_vps",
                "html-vps-status": "Đã xóa",
                "amount": "45.000",
                "is-special": 0,
                "username": "Administrator",
                "password": "fwO5S1IZORYXhzAv",
                "description": "",
                "auto-renew": 0,
                "type-vps": "VPS"
            }
        }
    ]
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Bạn chưa có VPS nào"
}

🔒 CẢNH BÁO BẢO MẬT

• Thông tin VPS bao gồm username và password - vui lòng bảo mật tuyệt đối
• Không chia sẻ auth_token với bất kỳ ai
• Thay đổi auth_token thường xuyên để tăng cường bảo mật
• Thông tin VPS chỉ hiển thị cho chủ tài khoản

Mua VPS

Mua một gói VPS mới với cấu hình tùy chỉnh.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `buy`
`vpsId`	Có	ID của gói VPS cần mua
`osid`	Có	ID hệ điều hành (os-id), là số nguyên đại diện cho hệ điều hành, ví dụ: 1 tương ứng với "Windows Server 2012 R2"
`billingcycle`	Có	Chu kỳ thanh toán: `monthly`, `quarterly`, `yearly`
`cpu`	Không	Số lõi CPU (mặc định theo gói VPS)
`ram`	Không	Dung lượng RAM (GB, mặc định theo gói VPS)
`disk`	Không	Dung lượng ổ đĩa (GB, mặc định theo gói VPS)
`coupon`	Không	Mã giảm giá

Phản hồi JSON mẫu

{
    "status": "success",
    "msg": "Tạo đơn hàng VPS thành công",
    "idvps": "1" // id của vps sau khi mua
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "msg": "Số dư của bạn không đủ 500000, vui lòng nạp thêm để thực hiện"
}

Khởi động VPS

Khởi động một VPS đã mua.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `start`
`param`	Có	ID của đơn hàng VPS

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Khởi động VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "VPS đã hết hạn, vui lòng gia hạn để tiếp tục"
}

Tắt VPS

Tắt một VPS đã mua.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `stop`
`param`	Có	ID của đơn hàng VPS

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Tắt VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "VPS đã hết hạn, vui lòng gia hạn để tiếp tục"
}

Khởi động lại VPS

Khởi động lại một VPS đã mua.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `restart`
`param`	Có	ID của đơn hàng VPS

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Khởi động lại VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "VPS đã hết hạn, vui lòng gia hạn để tiếp tục"
}

Cài lại VPS

Cài đặt lại hệ điều hành cho VPS.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `rebuild`
`param`	Có	ID của đơn hàng VPS
`os`	Có	ID của hệ điều hành để cài lại

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Cài lại VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Quý khách cần chọn hệ điều hành"
}

Gia hạn VPS

Gia hạn thời gian sử dụng cho VPS.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `extend`
`param`	Có	ID của đơn hàng VPS

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Gia hạn VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Số dư của bạn không đủ 500000 để gia hạn, vui lòng nạp thêm"
}

Chuyển quyền VPS

Chuyển quyền quản trị VPS cho người dùng khác.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `transfer`
`param`	Có	ID của đơn hàng VPS
`email`	Có	Email của người nhận chuyển quyền

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Chuyển quyền quản trị cho email: user@example.com thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Địa chỉ email không hợp lệ"
}

Nâng cấp VPS

Nâng cấp cấu hình CPU, RAM, hoặc ổ đĩa cho VPS.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `upgrade`
`param`	Có	ID của đơn hàng VPS
`cpu`	Không	Số lõi CPU mới
`ram`	Không	Dung lượng RAM mới (GB)
`disk`	Không	Dung lượng ổ đĩa mới (GB)

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Nâng cấp VPS thành công"
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "Số dư của bạn không đủ 300000 để nâng cấp, vui lòng nạp thêm"
}

Thông tin Profile

Lấy thông tin tài khoản người dùng, bao gồm số dư, tên người dùng và email.

Tham số

Tham số	Bắt buộc	Mô tả
`auth_token`	Có	Token xác thực của người dùng
`action`	Có	Giá trị: `profile`

Phản hồi JSON mẫu

{
    "status": "success",
    "message": "Lấy thông tin profile thành công",
    "data": {
        "money": "800",
        "username": "doilacloi",
        "email": "minhphsdepchai@gmail.com"
    }
}

Phản hồi lỗi mẫu

{
    "status": "error",
    "message": "auth_token không hợp lệ hoặc tài khoản bị khóa"
}

Dịch vụ

Quản lý

Tài khoản

Hỗ trợ

Tài liệu API VPS

Thông tin chung về API

🔒 Cảnh báo bảo mật

API Endpoints

Danh sách dịch vụ

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Danh sách hệ điều hành

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Danh sách Addons

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

⚠️ Lưu ý bảo mật

Danh sách VPS của bạn

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

🔒 CẢNH BÁO BẢO MẬT

Mua VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Khởi động VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Tắt VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Khởi động lại VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Cài lại VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Gia hạn VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Chuyển quyền VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Nâng cấp VPS

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu

Thông tin Profile

Tham số

Phản hồi JSON mẫu

Phản hồi lỗi mẫu