لا تحتاج عميل 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.
التعليقات
لا تعليقات بعد. كن الأول.