Tài liệu API VPS

Thông tin chung về API
Endpoint:
https://vietzcloud.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
  • Qua header: Authorization: Bearer {auth_token}
  • Hoặc gửi trong body: auth_token={token}
🔑 Bạn có thể lấy auth_token tại trang /customer/profile
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 Token xác thực của người dùng
action Giá trị: services
Phản hồi JSON mẫu
{
    "status": "success",
    "message": "Danh sách gói VPS khả dụng",
    "data": [
        {
            "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"
            }
        },
        {
            "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"
            }
        },
        {
            "name": "PLATIUM SALE",
            "price": {
                "monthly": {
                    "amount": 140000
                },
                "quarterly": {
                    "amount": 410000
                },
                "yearly": {
                    "amount": 1625000
                }
            },
            "specs": {
                "cpu": 4,
                "ram": 6,
                "disk": 40,
                "ip": "1 IPv4 Riêng",
                "os": "Windows/Linux",
                "bandwidth": "Không giới hạn"
            }
        },
        {
            "name": "PLATIUM VIP",
            "price": {
                "monthly": {
                    "amount": 203000
                },
                "quarterly": {
                    "amount": 599000
                },
                "yearly": {
                    "amount": 955000
                }
            },
            "specs": {
                "cpu": 4,
                "ram": 10,
                "disk": 80,
                "ip": "1 IPv4 Riêng",
                "os": "Windows/Linux",
                "bandwidth": "Không giới hạn"
            }
        },
        {
            "name": "PLATIUM VIP",
            "price": {
                "monthly": {
                    "amount": 0
                },
                "quarterly": {
                    "amount": 0
                },
                "yearly": {
                    "amount": 955000
                }
            },
            "specs": {
                "cpu": 4,
                "ram": 10,
                "disk": 80,
                "ip": "1 IPv4 Riêng",
                "os": "Windows/Linux",
                "bandwidth": "Không giới hạn"
            }
        },
        {
            "name": "PLATIUM PREMIUM",
            "price": {
                "monthly": {
                    "amount": 419000
                },
                "quarterly": {
                    "amount": 1247000
                },
                "yearly": {
                    "amount": 4973000
                }
            },
            "specs": {
                "cpu": 8,
                "ram": 18,
                "disk": 120,
                "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 Token xác thực của người dùng
action 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"
}
                            
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 Token xác thực của người dùng
action Giá trị: buy
vpsId ID của gói VPS cần mua
osid 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 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",
    "url": "/user/history/vps"
}
                            
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 Token xác thực của người dùng
action Giá trị: start
param 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 Token xác thực của người dùng
action Giá trị: stop
param 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 Token xác thực của người dùng
action Giá trị: restart
param 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 Token xác thực của người dùng
action Giá trị: rebuild
param ID của đơn hàng VPS
os 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 Token xác thực của người dùng
action Giá trị: extend
param 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 Token xác thực của người dùng
action Giá trị: transfer
param ID của đơn hàng VPS
email 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: [email protected] 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 Token xác thực của người dùng
action Giá trị: upgrade
param 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"
}
                            

© 2025 Copyrights by VIETZCLOUD.COM VIETZCLOUD - VPS UY TÍN GIÁ RẺ | Thiết kế bởi VIETZCLOUD.COM