האם אני צריך לקוח MCP?

לא. זה REST פשוט מעל HTTPS — שמיש מ-curl, מכל שפה, או מסוכן שמדבר HTTP. אם אתם כן משתמשים ב-MCP, אותן פעולות חשופות ככלים (ראו את מדריך החיבור).

איך אימות עובד?

קראו ל-/auth/register כדי לקבל טוקן Bearer (ללא סיסמה). שלחו אותו כ-header Authorization: Bearer בכל קריאה מאומתת. /products ציבורי.

איך אני משלם?

מַמנו יתרה מראש דרך /balance/topup (מחזיר כתובת קופה של קריפטו; שלמו ב-USDC/USDT). order אז מחייב את היתרה. אם לא-ממומן, order מחזיר חשבונית שאתם משלמים דרך /invoices/{id}/pay.

מה תגובת ה-order מכילה?

או paid_from_balance עם id של שירות (הקמה התחילה), או חשבונית לשלם. סקרו GET /services/{id} עד שהסטטוס active, ואז קראו את ה-host, port של SSH וסיסמת root חד-פעמית.

הזמינו VPS ב-4 קריאות API (quickstart של REST לסוכנים)

אתם לא צריכים לקוח MCP כדי להפעיל את EQVPS — ה-REST API עושה כל מה שסוכן צריך. כתובת בסיס: 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/..." }  ← pay it in 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 של תוכנית ו-os_id מה-available_os של אותה תוכנית.

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

העבירו 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": "<shown once for keyless servers>" , ... }

סקרו עד ש-status הוא active. בלוק ה-access מכיל את ה-host, port של SSH, ו-command מוכן-להדבקה; להזמנה חסרת-מפתח סיסמת ה-root החד-פעמית password מוחזרת בקריאה הראשונה.

הערות לסוכנים

שלחו Authorization: Bearer <YOUR_BEARER> בכל קריאה חוץ מ-/products.
שלמו ב-USDC/USDT (Base, Ethereum, Tron) — ללא כרטיס נדרש. העדיפו את היתרה מראש כך שצעד 3 הוא קריאה אחת.
פעולות רגישות (order, reset-password, reinstall, cancel) מוגבלות-קצב; שימוש רגיל בהחלט בתוך המגבלות.
מעדיפים כלים על HTTP גולמי? אותן פעולות הן כלי MCP — ראו את מדריך החיבור והפניית הכלים. תיעוד מלא: /docs.