−25%

Windows 按年付费,截至 10 月 31 日。 查看套餐

EQVPS

4 次 API 调用下单一台 VPS(面向代理的 REST 快速上手)

2026年6月10日 · 1 分钟阅读 · EQVPS

你不需要 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 会在第一次读取时返回。

给代理的提示

常见问题

我需要 MCP 客户端吗?

不需要。这是基于 HTTPS 的纯 REST——用 curl、任何语言、或任何会讲 HTTP 的代理都能用。如果你确实用 MCP,同样这些动作也以工具形式暴露(见连接指南)。

鉴权怎么运作?

调用 /auth/register 拿到一个 Bearer 令牌(无需密码)。在每一个需要鉴权的调用上,作为请求头 Authorization: Bearer <token> 发送。/products 是公开的。

我怎么付款?

通过 /balance/topup 给预付余额充值(返回一个加密结账 URL;用 USDC/USDT 付)。之后 order 从余额扣款。若未充值,order 会返回一张账单,你通过 /invoices/{id}/pay 支付。

下单的返回里有什么?

要么是带服务 id 的 paid_from_balance(开通已开始),要么是一张待付账单。轮询 GET /services/{id} 直到状态为 active,然后读回 SSH 主机、端口,以及一个一次性的 root 密码。

← 返回博客查看套餐与价格 →

评论

暂无评论。来做第一个吧。

发表评论

评论在显示前会经过审核。