4回のAPIコールでVPSを注文（エージェント向けRESTクイックスタート）

EQVPSを動かすのにMCPクライアントは要りません — 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" }, ... ] }, ... ] }

プランの slug と、そのプランの available_os から 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

鍵ベースのrootログインには ssh_key（公開鍵）を渡します。資金の入った残高なら注文は即座に支払われプロビジョニングが始まります。

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、Polygon）で支払う — カード不要。ステップ3が一コールになるようプリペイド残高を推奨。
• 機微な操作（order、reset-password、reinstall、cancel）はレート制限あり；通常利用は制限内に十分。
• 素のHTTPよりツールが好み？同じアクションがMCPツールです — 接続ガイドとツールリファレンスを参照。全ドキュメント：/docs。