API VPS Cloud

Tài liệu hướng dẫn sử dụng API dịch vụ VPS Cloud

Quay lại

API Key

Đang tải...

Endpoints
GET Danh sách gói VPS GET Danh sách OS GET Giá Addon GET Lịch sử VPS POST Mua VPS POST Thao tác VPS ERR Mã lỗi

GET Danh sách gói VPS

Lấy danh sách tất cả gói VPS Cloud Gold đang bán.

Endpoint

GET https://ezhost.vn/api/vps-gold/services?key_app={key_app}&token={token}

Tham số

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token

cURL

curl -X GET "https://ezhost.vn/api/vps-gold/services?key_app=YOUR_KEY_APP&token=YOUR_TOKEN"

Phản hồi mẫu

{
  "status": "success",
  "msg": "Danh sách gói VPS Cloud Gold",
  "data": [
    {
      "id": "1",
      "name": "VPS Gold 1",
      "detail": { "cpu": "2 vCPU", "ram": "2GB", "ssd": "20GB" },
      "price": { "monthly": { "amount": 150000 } }
    }
  ]
}

GET Danh sách hệ điều hành (OS)

Lấy danh sách OS có thể cài cho VPS (dùng cho mua mới hoặc rebuild).

Endpoint

GET https://ezhost.vn/api/vps-gold/os?key_app={key_app}&token={token}

Tham số

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token

cURL

curl -X GET "https://ezhost.vn/api/vps-gold/os?key_app=YOUR_KEY_APP&token=YOUR_TOKEN"

Phản hồi mẫu

{
  "status": "success",
  "msg": "Danh sách hệ điều hành",
  "data": [
    { "os_id": "101", "os_name": "Ubuntu 22.04" },
    { "os_id": "102", "os_name": "CentOS 7" },
    { "os_id": "103", "os_name": "Windows Server 2022" }
  ]
}

GET Giá Addon (CPU / RAM / Disk)

Lấy bảng giá addon CPU, RAM, Disk để tính chi phí nâng cấp VPS.

Endpoint

GET https://ezhost.vn/api/vps-gold/addon?key_app={key_app}&token={token}

Tham số

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token

cURL

curl -X GET "https://ezhost.vn/api/vps-gold/addon?key_app=YOUR_KEY_APP&token=YOUR_TOKEN"

Phản hồi mẫu

{
  "status": "success",
  "msg": "Danh sách addon VPS",
  "data": [
    {
      "id": "1",
      "name": "Addon CPU",
      "type_addon": "addon_cpu",
      "price": { "monthly": { "amount": 30000 } }
    }
  ]
}

GET Lịch sử VPS đã mua

Lấy danh sách VPS đã mua. Thêm id để xem chi tiết 1 VPS (IP, mật khẩu, trạng thái).

Endpoint

GET https://ezhost.vn/api/vps-gold/history?key_app={key_app}&token={token}&id={id}

Tham số

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token
idTuỳ chọnID đơn hàng để xem chi tiết

cURL (danh sách)

curl -X GET "https://ezhost.vn/api/vps-gold/history?key_app=YOUR_KEY_APP&token=YOUR_TOKEN"

cURL (chi tiết 1 VPS)

curl -X GET "https://ezhost.vn/api/vps-gold/history?key_app=YOUR_KEY_APP&token=YOUR_TOKEN&id=5"

Phản hồi mẫu (chi tiết)

{
  "status": "success",
  "msg": "Chi tiết VPS",
  "data": {
    "id": "5",
    "ip": "103.252.137.101",
    "username": "root",
    "password": "#xYz123",
    "status": "running",
    "package_name": "2 vCPU / 2GB RAM / 20GB SSD",
    "day_left": "28 ngày"
  }
}

POST Mua VPS

Mua gói VPS Cloud Gold. Nếu tạo VPS thất bại sẽ tự động hoàn tiền.

Endpoint

POST https://ezhost.vn/api/vps-gold/buy

Tham số (form-data)

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token
vpsIdBắt buộcID gói VPS (lấy từ API services)
osBắt buộcID hệ điều hành (lấy từ API os)
billingcycleBắt buộcChu kỳ: monthly, quarterly...
cpuTuỳ chọnSố addon CPU thêm
ramTuỳ chọnSố addon RAM thêm
diskTuỳ chọnSố addon Disk thêm
couponTuỳ chọnMã giảm giá

cURL

curl -X POST "https://ezhost.vn/api/vps-gold/buy" \ -d "key_app=YOUR_KEY_APP" \ -d "token=YOUR_TOKEN" \ -d "vpsId=1" \ -d "os=101" \ -d "billingcycle=monthly" \ -d "cpu=0" \ -d "ram=0" \ -d "disk=0"

Phản hồi mẫu

{
  "status": "success",
  "msg": "Mua VPS thành công!",
  "data": {
    "vps-id": 12345,
    "ip": "103.252.137.101",
    "username": "root",
    "password": "#oaDCViScJWjEtbU"
  }
}

POST Thao tác VPS

Start / Stop / Restart / Rebuild / Gia hạn / Nâng cấp VPS. Tự động hoàn tiền nếu thất bại.

Endpoint

POST https://ezhost.vn/api/vps-gold/action

Tham số (form-data)

TênLoạiMô tả
key_appBắt buộcAPI Key App
tokenBắt buộcAPI Token
paramBắt buộcID đơn hàng VPS
actionBắt buộc 1 Start  |  2 Stop  |  3 Restart  |  4 Rebuild  |  5 Gia hạn  |  10 Nâng cấp
os_idaction=4ID OS mới khi rebuild
cpuaction=10Số addon CPU khi nâng cấp
ramaction=10Số addon RAM khi nâng cấp
diskaction=10Số addon Disk khi nâng cấp

cURL (restart)

curl -X POST "https://ezhost.vn/api/vps-gold/action" \ -d "key_app=YOUR_KEY_APP" \ -d "token=YOUR_TOKEN" \ -d "param=5" \ -d "action=3"

cURL (nâng cấp)

curl -X POST "https://ezhost.vn/api/vps-gold/action" \ -d "key_app=YOUR_KEY_APP" \ -d "token=YOUR_TOKEN" \ -d "param=5" \ -d "action=10" \ -d "cpu=1" \ -d "ram=2" \ -d "disk=1"

Phản hồi mẫu

{
  "status": "success",
  "msg": "Restart VPS thành công"
}

Mã lỗi phổ biến

StatusMsgMô tả
errorThiếu key_app hoặc tokenChưa gửi đủ thông tin xác thực
errorkey_app hoặc token không hợp lệKey không tồn tại hoặc đã bị vô hiệu
errorTài khoản đã bị khóaUser bị banned
errorSố dư không đủTài khoản không đủ tiền
errorVPS đã hết hạnCần gia hạn trước khi thao tác
errorVPS còn quá ít ngàyCần gia hạn trước khi nâng cấp
errorGói VPS không tồn tạiID gói không hợp lệ hoặc hết bán
Hỗ trợ