هل أحتاج عميل MCP؟

لا. هذا REST بسيط عبر HTTPS — قابل للاستخدام من curl أو أي لغة أو وكيل يتحدّث HTTP. إن استخدمت MCP، فالإجراءات نفسها معروضة كأدوات (راجع دليل الربط).

كيف تعمل المصادقة؟

استدعِ /auth/register للحصول على رمز Bearer (بلا كلمة مرور). أرسله كترويسة Authorization: Bearer في كل استدعاء مُصادَق. /products عام.

موّل رصيدًا مدفوعًا مسبقًا عبر /balance/topup (يُعيد رابط دفع مشفّر؛ ادفع بـ USDC/USDT). ثم يخصم الطلب من الرصيد. إن لم يكن ممولًا، يُعيد الطلب فاتورة تدفعها عبر /invoices/{id}/pay.

ماذا تحتوي استجابة الطلب؟

إمّا paid_from_balance مع معرّف خدمة (بدأ التجهيز)، أو فاتورة للدفع. استعلم GET /services/{id} حتى تصير الحالة active، ثم اقرأ مضيف SSH ومنفذه وكلمة مرور root لمرة واحدة.

اطلب VPS في 4 استدعاءات API (بداية سريعة لـ 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/..." }  ← ادفعه بـ 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": 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 لمرة واحدة عند أوّل قراءة.

ملاحظات للوكلاء

أرسل Authorization: Bearer <YOUR_BEARER> في كل استدعاء عدا /products.
ادفع بـ USDC/USDT (Base أو Ethereum أو Polygon) — بلا حاجة لبطاقة. فضّل الرصيد المدفوع مسبقًا كي تكون الخطوة 3 استدعاءً واحدًا.
الإجراءات الحسّاسة (طلب، إعادة تعيين كلمة مرور، إعادة تثبيت، إلغاء) محدودة المعدّل؛ الاستخدام العادي ضمن الحدود بأريحية.
تفضّل الأدوات على HTTP خام؟ الإجراءات نفسها أدوات MCP — راجع دليل الربط ومرجع الأدوات. التوثيق الكامل: /ar/docs.