EQVPS
REST API · MCP

EQVPS API

Đăng ký, nạp tiền bằng crypto và đặt một VPS hoàn toàn bằng mã — không KYC, không con người trong vòng lặp. Được xây dựng cho nhà phát triển và cho các AI agent tự cấp phát máy chủ của mình.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
URL cơ sởhttps://api.eqvps.com/api/v1/eqvps
Thử trực tiếpĐặc tả OpenAPITài liệu tham khảo đầy đủ

Bắt đầu nhanh

Bốn lệnh gọi: từ số không đến một VPS đang chạy. Các token bên dưới là placeholder — đừng bao giờ dán token thật lên một trang.

# 1. Register — returns a Bearer token (no KYC, no human step)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }
# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # pay on-chain, balance credits automatically
# 3. Order a VPS — paid from balance (get slug + os_id from GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# 4. Read SSH access — one-time root password is shown once here
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Các endpoint chính

Bề mặt cốt lõi. Mở explorer tương tác cho từng tham số và phản hồi.

POST/auth/registerTạo một tài khoản và nhận một Bearer token. Không mật khẩu, không bước thủ công của con người.
GET/productsLiệt kê tất cả các gói VPS với thông số, giá và các image OS được hỗ trợ.
POST/balance/topupTạo một hóa đơn nạp tiền bằng crypto; trả về một URL thanh toán. Số dư được ghi có khi có xác nhận on-chain.
POST/ordersĐặt một VPS. Thanh toán từ số dư nếu đã nạp, nếu không sẽ trả về một hóa đơn chưa thanh toán.
GET/services/{id}Trạng thái đầy đủ + truy cập SSH trực tiếp. Mật khẩu root dùng một lần được hiển thị tại đây một lần.
GET/balanceSố dư tín dụng trả trước và loại tiền tệ.

Xem từng endpoint, tham số và schema trong explorer tương tác →

Dành cho AI agent

Một agent có thể tự đi từ con số không đến một máy chủ đang hoạt động — khám phá, thanh toán, cấp phát và đọc SSH, tất cả qua API hoặc MCP.

MCP đang hoạt động — không phải dự kiến.

Trỏ bất kỳ MCP client nào tới https://mcp.eqvps.com/mcp (Streamable HTTP). 26 công cụ bao phủ khám phá, tài khoản, thanh toán và toàn quyền kiểm soát VPS. Công cụ công khai: list_plans, register_account, login; mọi thứ khác cần một Bearer token.

Luồng tự động

1. register_account → nhận một Bearer token
2. topup_balance → thanh toán URL checkout bằng USDC/USDT
3. order_vps → cấp phát từ số dư
4. get_vps_status → poll cho đến khi active, đọc SSH (host, port, lệnh, mật khẩu dùng một lần)

Tài nguyên máy đọc được

Lỗi

Mã trạng thái HTTP tiêu chuẩn. Body mang một trường message khi có lỗi.

Trạng tháiÝ nghĩa
200 / 201OK — request succeeded / resource created.
401Missing or invalid Bearer token.
403Authenticated, but not the owner of this resource.
404Resource not found.
409State conflict (e.g. an unpaid top-up already exists).
422Validation error — check the request body.
429Rate limited — back off and retry.

Giới hạn tần suất

Các hành động nhạy cảm (đặt hàng, nạp tiền, đặt lại mật khẩu, cài lại, console) bị giới hạn tần suất theo tài khoản. Tự động hóa thông thường nằm gọn trong giới hạn; khi gặp 429, hãy lùi lại và thử lại.

Bắt đầu xây dựng ngay

Lấy đặc tả, mở explorer, hoặc đọc tài liệu tham khảo đầy đủ dạng tường thuật kèm hướng dẫn cài đặt MCP.