MCP client ያስፈልገኛል?

አይ። ይህ በHTTPS ላይ ተራ REST ነው — ከcurl፣ ከማንኛውም ቋንቋ፣ ወይም HTTP ከሚናገር agent ጠቃሚ። MCP የሚጠቀሙ ከሆኑ ተመሳሳይ actions እንደ tools ይጋለጣሉ (connect-guideን ይመልከቱ)።

auth እንዴት ይሰራል?

Bearer token ለማግኘት /auth/register ይጥሩ (password የለም)። በእያንዳንዱ authenticated ጥሪ ላይ እንደ header Authorization: Bearer ይላኩት። /products ይፋዊ ነው።

እንዴት እከፍላለሁ?

በ/balance/topup ቅድመ-ክፍያ balance ይሙሉ (crypto checkout URL ይመልሳል፤ በUSDC/USDT ይክፈሉ)። order ከዚያ balanceን ይቀንሳል። ካልተሞላ order የሚከፍሉት invoice በ/invoices/{id}/pay ይመልሳል።

order response ምን ይይዛል?

ወይ service-id ያለው paid_from_balance (provisioning ተጀምሯል)፣ ወይም የሚከፈል invoice። status active እስኪሆን GET /services/{id} ይpoll ያድርጉ፣ ከዚያ SSH host፣ port፣ እና ባንድ-ጊዜ root password ያንብቡ።

በ4 API ጥሪ VPS ይዘዙ (ለagents REST quickstart)

EQVPSን ለማንቀሳቀስ MCP client አያስፈልግዎትም — REST API agent የሚፈልገውን ሁሉ ያደርጋል። Base URL: https://api.eqvps.com/api/v1/eqvps። ሙሉ flowው በአራት ጥሪ ይኸውና።

0. (ባንድ ጊዜ) ቅድመ-ክፍያ balance ይሙሉ

ማዘዝ አንድ ጥሪ እንዲሆን፣ መጀመሪያ balance ይሙሉ። የተመለሰውን checkout በ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/..." }  ← pay it in USDC/USDT

1. ይመዝገቡ → Bearer token

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

Password የለም፣ human step የለም። tokenን ያስቀምጡ፤ ከታች እንደ Authorization: Bearer <YOUR_BEARER> ይላኩት።

2. plans ይዘርዝሩ → 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" }, ... ] }, ... ] }

የplan slug እና ከዚያ planው 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: { "paid_from_balance": true, "service_id": <id> }
#   or unfunded:       { "invoice": { "id": <id> } }  → pay: POST /invoices/{id}/pay → checkout_url

ለkey-based root login ssh_key (public key) ይላኩ። በተሞላ balance orderው ወዲያውኑ ይከፈላል እና provisioning ይጀምራል።

4. access ያንብቡ

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": "<shown once for keyless servers>" , ... }

status active እስኪሆን ይpoll ያድርጉ። access block SSH host፣ port፣ እና ዝግጁ-ለ-መለጠፍ command አለው፤ ለkeyless order ባንድ-ጊዜ root password በመጀመሪያ ንባብ ይመለሳል።

ለagents ማስታወሻዎች

ከ/products በስተቀር በእያንዳንዱ ጥሪ ላይ Authorization: Bearer <YOUR_BEARER> ይላኩ።
በUSDC/USDT (Base, Ethereum, Tron) ይክፈሉ — card አያስፈልግም። step 3 አንድ ጥሪ እንዲሆን ቅድመ-ክፍያ balanceን ይምረጡ።
Sensitive actions (order, reset-password, reinstall, cancel) rate-limited ናቸው፤ ተራ አጠቃቀም ከገደቦቹ ውስጥ በደንብ ነው።
ከraw HTTP ይልቅ tools ይመርጣሉ? ተመሳሳይ actions MCP tools ናቸው — connect-guide እና tools reference ይመልከቱ። ሙሉ docs: /docs።