4 次 API 呼叫下單一台 VPS（面向代理的 REST 快速上手）

您不需要 MCP 用戶端來驅動 EQVPS——REST API 就能做代理需要的一切。基礎 URL：https://api.eqvps.com/api/v1/eqvps。整個流程四次呼叫如下。

0.（一次性）給預付餘額儲值

為了讓下單只是一次呼叫，先給餘額儲值。用 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/..." }  ← 用 USDC/USDT 付款

1. 註冊 → Bearer 權杖

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": {...} }

無需密碼，無需人工步驟。把權杖存起來；在下面作為 Authorization: Bearer <YOUR_BEARER> 傳送。

2. 列出方案 → 選 product + os_id（公開）

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" }, ... ] }, ... ] }

從某個方案的 available_os 裡選一個方案 slug 和一個 os_id。

3. 下單一台 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..."}'
# → 從餘額支付: { "paid_from_balance": true, "service_id": <id> }
#   或未儲值:   { "invoice": { "id": <id> } }  → 支付: POST /invoices/{id}/pay → checkout_url

傳入一個 ssh_key（公鑰）以用金鑰方式登入 root。餘額已儲值時，訂單會立刻付清、開通隨即開始。

4. 讀取存取資訊

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": "<無金鑰伺服器僅顯示一次>" , ... }

輪詢直到 status 為 active。access 塊裡有 SSH 主機、埠，以及一條可直接貼上的 command；對無金鑰下單，一次性的 root password 會在第一次讀取時返回。

給代理的提示

• 除 /products 外，每個呼叫都發送 Authorization: Bearer <YOUR_BEARER>。
• 用 USDC/USDT（Base、Ethereum、Tron）付款——無需信用卡。優先用預付餘額，這樣第 3 步就是一次呼叫。
• 敏感動作（下單、重設密碼、重灌、取消）有速率限制；正常使用遠在限額之內。
• 比起裸 HTTP 更想用工具？同樣這些動作就是 MCP 工具——見連線指南和工具參考。完整文件：/docs。