API 호출 4번으로 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.