vpsnet.vn
Tổng quan
Proxy
VPS của tôiProxy của tôi
Mua license key
License của tôi
Mua captcha
Captcha của tôi
Ngân hàngCrypto (USDT)Thẻ cào
Hoá đơn
Lịch sử giao dịch
Thống kêLịch sử hoa hồngRút hoa hồng
Tạo website đại lýSắp có
API Cloud VPSAPI ProxySandbox APIAPI Captcha
Tạo ticket mớiTicket của tôi
Tin tức
Câu hỏi thường gặp
Liên hệ
vpsnet.vn
Đăng nhậpĐăng ký

API Cloud VPS

Bắt đầu

  • Xác thực & cơ bản
  • Lấy auth-token

Khởi tạo

  • Danh sách mục VPS
  • Gói VPS của 1 mục
  • Hệ điều hành của gói
  • Tài nguyên thêm của gói
  • Mua VPS

Quản lý VPS

  • Danh sách VPS
  • Chi tiết VPS (kèm mật khẩu)
  • Gia hạn VPS
  • Bật / tắt / khởi động lại VPS
  • Bật / tắt tự gia hạn VPS

Tài khoản

  • Thông tin tài khoản
  • Số dư & lịch sử biến động

API key

Gửi trong header api-key của mọi lệnh. Không chia sẻ API key cho người khác.

Đăng nhập để lấy API key

Luồng sử dụng

Luồng mua: lấy danh sách mục → gói của mục → OS (và tài nguyên thêm nếu cần) của gói → tạo đơn. Sau khi mua, gọi chi tiết đơn để lấy IP / tài khoản / mật khẩu (VPS có thể mất vài phút để cài hệ điều hành).

Chu kỳ thanh toán (billingCycle): monthly, quarterly, semi_annually, annually, biennially, triennially. Chỉ dùng chu kỳ có trong cycles của gói.

Luồng xác thực

  1. Gọi POST /api/agency/get-token với header api-key để nhận auth-token (hiệu lực 8 giờ).
  2. Gửi cả hai header api-key và auth-token với mọi lệnh khác. Token hết hạn thì lấy lại ở bước 1.

Thử tích hợp không mất tiền bằng khoá thử tại Sandbox API.

Giới hạn

  • Số request mỗi phút theo cấu hình của API key (mặc định 60).
  • Lệnh trừ tiền (mua, gia hạn): tối đa 5 lệnh / 10 giây mỗi loại và 20 lệnh / phút mỗi key.
  • Gửi header Idempotency-Key (vd UUID) với lệnh mua, gia hạn. Gửi lại cùng khoá và cùng nội dung trong 24 giờ nhận lại kết quả lần đầu, không trừ tiền lần 2.
  • Vượt giới hạn trả mã 429 kèm header Retry-After (số giây chờ).

Định dạng phản hồi & mã lỗi

Phản hồi có dạng { error, data?, message?, meta }. error = 0 là thành công, khác 0 là mã lỗi trùng HTTP status. message là tiếng Việt, hiển thị thẳng cho người dùng được.

400Dữ liệu không hợp lệ hoặc thao tác không thực hiện được (vd số dư không đủ)
401Thiếu hoặc sai api-key / auth-token
403Thiếu scope, IP không được phép hoặc tài khoản bị khoá
404Không tìm thấy
409Đang có thao tác khác trên dịch vụ này
429Vượt giới hạn request
502Máy chủ chưa phản hồi, thử lại sau
503Hệ thống bảo trì

Địa chỉ API

Base URL
/api/agency

Body gửi lên dạng JSON, header Content-Type: application/json.

Điều khoản sử dụng|Bảo vệ dữ liệu cá nhân|Hoàn tiền|Khiếu nại

© 2026 vpsnet.vn