Chuyển đến nội dung chính
VNHOST.VN – Cloud Server Chất Lượng Cao, Tốc Độ Vượt Trội
  • Tổng quan
  • Trang chủ
  • Dịch vụ
  • Hosting giá rẻ
  • Cloud vps việt
  • Mã nguồn
  • Hỗ trợ & thông tin
  • Gửi yêu cầu hỗ trợ
  • Tài liệu API
  • Blog tin tức
  • Câu hỏi thường gặp
  • Liên hệ
  • Tài khoản
  • Đăng nhập
  • Đăng ký

© 2025 - 2026 VNHOST.VN – Cloud Server Chất Lượng Cao, Tốc Độ Vượt Trội. Được vận hành bởi Hà Văn Chung.

Software by Văn Chung LIMITED

Thuê Hosting mớiThuê Cloud vps việtMã nguồn
Tổng quanĐăng kýHỗ trợĐăng nhập
  1. Trang chủ
  2. Tài liệu API
Quản lý API token
VNHOST.VN – Cloud Server Chất Lượng Cao, Tốc Độ Vượt Trội REST API

API Cloud vps việt

Liệt kê gói, đặt VPS và quản lý toàn bộ vòng đời dịch vụ qua một endpoint tương thích hệ thống hiện tại.

Base URL
https://vnhost.vn/vanchungvnhost/api/v19
Xác thực Bearer token

Gửi Authorization: Bearer YOUR_API_TOKEN. Một số client cũ có thể gửi auth_token trong body, nhưng header được khuyến nghị.

Cloud VPS endpoints
POSTDanh sách dịch vụPOSTDanh sách hệ điều hànhPOSTDanh sách AddonPOSTDanh sách VPS của tài khoảnPOSTMua VPSPOSTKhởi động VPSPOSTTắt VPSPOSTKhởi động lại VPSPOSTCài lại VPSPOSTGia hạn VPSPOSTChuyển quyền VPSPOSTNâng cấp VPSPOSTThông tin tài khoản
POST/vanchungvnhost/api/v19

Danh sách dịch vụ

Trả về các gói VPS đang hoạt động cùng chu kỳ giá và cấu hình tài nguyên.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "services",
  "type": "vps-platinum"
}'
JSON response
{
  "ok": true,
  "message": "Danh sách gói VPS khả dụng",
  "data": [
    {
      "id": 2,
      "name": "VPS 1-2-20",
      "base_price": {
        "monthly": {
          "amount": 60000
        }
      },
      "price": {
        "monthly": {
          "amount": 54000,
          "base_amount": 60000,
          "discount_percent": 10
        }
      },
      "discount_percent": 10,
      "specs": {
        "cpu": 1,
        "ram": 2,
        "disk": 20
      }
    }
  ]
}
POST/vanchungvnhost/api/v19

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

Đọc danh sách OS đã đồng bộ trong database cho nhà cung cấp của loại VPS.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "os",
  "type": "vps-platinum"
}'
JSON response
{
  "data": [
    {
      "id": "ubuntu-22",
      "name": "Ubuntu 22.04",
      "image": "/assets/images/ubuntu.png"
    }
  ]
}
POST/vanchungvnhost/api/v19

Danh sách Addon

Trả về CPU, RAM, SSD hoặc tài nguyên bổ sung có thể mua kèm.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "addons",
  "type": "vps-platinum"
}'
JSON response
{
  "ok": true,
  "discount_percent": 10,
  "data": [
    {
      "id": 1,
      "name": "RAM",
      "type_addon": "ram",
      "base_price": {
        "monthly": {
          "amount": 20000
        }
      },
      "price": {
        "monthly": {
          "amount": 18000,
          "base_amount": 20000,
          "discount_percent": 10
        }
      }
    }
  ]
}
POST/vanchungvnhost/api/v19

Danh sách VPS của tài khoản

Trả về các VPS thuộc tài khoản đang xác thực.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "listvps",
  "type": "vps-platinum"
}'
JSON response
{
  "ok": true,
  "data": [
    {
      "id": 108,
      "vps_id": 4312,
      "status": "active",
      "billingcycle": "monthly"
    }
  ]
}
POST/vanchungvnhost/api/v19

Mua VPS

Tạo đơn VPS, trừ số dư và gửi yêu cầu tạo máy sang nhà cung cấp.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
vpsIdnumberCóID gói VPS.
billingcyclestringCóChu kỳ: monthly, quarterly, semi_annually, annually…
osidstringCóMã hệ điều hành nhận từ action=os.
cpu_addonnumberKhôngSố CPU mua thêm.
ram_addonnumberKhôngSố GB RAM mua thêm.
disk_addonnumberKhôngSố đơn vị SSD mua thêm.
couponstringKhôngMã giảm giá nếu có.
client_ipstringKhôngIP người mua cuối do hệ thống tích hợp cung cấp. Có thể dùng header X-VNHost-Client-IP.
client_user_agentstringKhôngUser-Agent/thiết bị người mua cuối. Có thể dùng header X-VNHost-Client-User-Agent.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "buy",
  "type": "vps-platinum",
  "vpsId": 2,
  "billingcycle": "monthly",
  "osid": "ubuntu-22",
  "cpu_addon": 0,
  "ram_addon": 0,
  "disk_addon": 0,
  "client_ip": "203.0.113.10",
  "client_user_agent": "Mozilla/5.0 ..."
}'
JSON response
{
  "ok": true,
  "message": "Đã tạo VPS thành công",
  "data": {
    "id": 108,
    "subtotal": 60000,
    "account_discount_percent": 10,
    "account_discount": 6000,
    "total_discount": 6000,
    "total": 54000,
    "url": "/customer/history/vps/platinum"
  }
}
POST/vanchungvnhost/api/v19

Khởi động VPS

Bật VPS đang dừng.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS trong hệ thống.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "start",
  "type": "vps-platinum",
  "param": 108
}'
JSON response
{
  "ok": true,
  "message": "Thao tác thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Tắt VPS

Tắt VPS đang chạy.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS trong hệ thống.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "stop",
  "type": "vps-platinum",
  "param": 108
}'
JSON response
{
  "ok": true,
  "message": "Thao tác thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Khởi động lại VPS

Khởi động lại VPS.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS trong hệ thống.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "restart",
  "type": "vps-platinum",
  "param": 108
}'
JSON response
{
  "ok": true,
  "message": "Thao tác thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Cài lại VPS

Cài lại hệ điều hành. Toàn bộ dữ liệu trên VPS có thể bị xóa.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS.
osstringCóMã OS mới.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "rebuild",
  "type": "vps-platinum",
  "param": 108,
  "os": "ubuntu-22"
}'
JSON response
{
  "ok": true,
  "message": "Đã gửi yêu cầu cài lại VPS",
  "data": {}
}
POST/vanchungvnhost/api/v19

Gia hạn VPS

Gia hạn VPS theo chu kỳ đã chọn và trừ số dư tài khoản.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS.
billingcyclestringKhôngChu kỳ gia hạn mới; bỏ trống để dùng chu kỳ hiện tại.
couponstringKhôngMã giảm giá.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "extend",
  "type": "vps-platinum",
  "param": 108,
  "billingcycle": "monthly"
}'
JSON response
{
  "ok": true,
  "message": "Gia hạn thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Chuyển quyền VPS

Chuyển dịch vụ cho tài khoản khác trong hệ thống.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS.
usernamestringCóTên tài khoản người nhận.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "transfer",
  "type": "vps-platinum",
  "param": 108,
  "username": "nguoinhan"
}'
JSON response
{
  "ok": true,
  "message": "Chuyển quyền thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Nâng cấp VPS

Nâng cấp gói hoặc tài nguyên của VPS đang sở hữu.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
paramnumberCóID đơn VPS.
plan_idnumberKhôngID gói mới.
cpunumberKhôngCPU mua thêm.
ramnumberKhôngRAM mua thêm.
disknumberKhôngSSD mua thêm.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "upgrade",
  "type": "vps-platinum",
  "param": 108,
  "plan_id": 3
}'
JSON response
{
  "ok": true,
  "message": "Nâng cấp thành công",
  "data": {}
}
POST/vanchungvnhost/api/v19

Thông tin tài khoản

Trả về số dư và thông tin cơ bản của tài khoản sở hữu token.

Tham số

Tham số API
TênKiểuBắt buộcMô tả
actionstringCóTên hành động cần thực hiện.
typestringCóLoại dịch vụ. Dùng vps-platinum cho Cloud vps việt.
auth_tokenstringKhôngCó thể gửi trong body thay cho Authorization header.
cURL request
curl --request POST \
  --url 'https://vnhost.vn/vanchungvnhost/api/v19' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "profile",
  "type": "vps-platinum"
}'
JSON response
{
  "ok": true,
  "data": {
    "money": 500000,
    "username": "demo",
    "email": "[email protected]"
  }
}