Tôi có cần một MCP client không?

Không. Đây là REST thuần qua HTTPS — dùng được từ curl, bất kỳ ngôn ngữ nào, hoặc một agent nói HTTP. Nếu bạn có dùng MCP, cùng các hành động được phơi bày như các công cụ (xem hướng dẫn kết nối).

Xác thực hoạt động thế nào?

Gọi /auth/register để lấy một Bearer token (không mật khẩu). Gửi nó dưới dạng header Authorization: Bearer trên mỗi lệnh gọi đã xác thực. /products là công khai.

Tôi thanh toán thế nào?

Nạp một số dư trả trước qua /balance/topup (trả về một URL thanh toán crypto; thanh toán bằng USDC/USDT). order rồi trừ số dư. Nếu chưa nạp, order trả về một hóa đơn bạn thanh toán qua /invoices/{id}/pay.

Phản hồi order chứa gì?

Hoặc paid_from_balance với một id dịch vụ (cấp phát đã bắt đầu), hoặc một hóa đơn để thanh toán. Poll GET /services/{id} cho tới khi trạng thái là active, rồi đọc host SSH, port, và một mật khẩu root dùng một lần.

Đặt một VPS trong 4 lệnh gọi API (hướng dẫn nhanh REST cho agent)

Bạn không cần một MCP client để điều khiển EQVPS — REST API làm mọi thứ một agent cần. URL cơ sở: https://api.eqvps.com/api/v1/eqvps. Đây là toàn bộ luồng trong bốn lệnh gọi.

0. (một lần) Nạp một số dư trả trước

Để đặt hàng là một lệnh gọi đơn, nạp một số dư trước. Thanh toán trang thanh toán trả về bằng USDC/USDT:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← thanh toán nó bằng USDC/USDT

1. Đăng ký → Bearer token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Không mật khẩu, không bước con người. Lưu token; gửi nó dưới dạng Authorization: Bearer <YOUR_BEARER> bên dưới.

2. Liệt kê các gói → chọn product + os_id (công khai)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

Chọn một slug gói và một os_id từ available_os của gói đó.

3. Đặt một VPS

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → thanh toán từ số dư: { "paid_from_balance": true, "service_id": <id> }
#   hoặc chưa nạp:       { "invoice": { "id": <id> } }  → thanh toán: POST /invoices/{id}/pay → checkout_url

Truyền một ssh_key (khóa công khai) cho đăng nhập root dựa-trên-khóa. Với một số dư đã nạp đơn hàng được thanh toán tức thì và cấp phát bắt đầu.

4. Đọc truy cập

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<hiển thị một lần cho các máy chủ không-khóa>" , ... }

Poll cho tới khi status là active. Khối access có host SSH, port, và một command sẵn-sàng-dán; cho một đơn hàng không-khóa password root dùng một lần được trả về ở lần đọc đầu tiên.

Lưu ý cho agent

Gửi Authorization: Bearer <YOUR_BEARER> trên mỗi lệnh gọi trừ /products.
Thanh toán bằng USDC/USDT (Base, Ethereum, Tron) — không cần thẻ. Ưu tiên số dư trả trước để bước 3 là một lệnh gọi.
Các hành động nhạy cảm (order, reset-password, reinstall, cancel) bị giới hạn tần suất; việc dùng bình thường nằm gọn trong giới hạn.
Thích các công cụ hơn HTTP thô? Cùng các hành động là các công cụ MCP — xem hướng dẫn kết nối và tài liệu công cụ. Tài liệu đầy đủ: /docs.