EQVPS
لوحة التحكمابدأ الآن
REST API · MCP

واجهة EQVPS API

سجّل، اشحن بالعملات المشفّرة، واطلب VPS بالكامل عبر البرمجة — دون KYC ودون تدخل بشري. مبنية للمطوّرين ولوكلاء الذكاء الاصطناعي الذين يجهّزون خوادمهم بأنفسهم.

OpenAPI 3.1MCP live · 47 toolsBearer authREST + MCP
عنوان URL الأساسيhttps://api.eqvps.com/api/v1/eqvps
جرّبها مباشرةمواصفة OpenAPIالمرجع الكامل

بداية سريعة

أربعة استدعاءات: من الصفر إلى VPS يعمل. الرموز أدناه عناصر نائبة — لا تلصق رمزًا حقيقيًا في صفحة.

# ١. سجّل — يُعيد رمز Bearer (بلا KYC، بلا خطوة بشرية)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# ← { "token": "<YOUR_API_TOKEN>" }
# ٢. اشحن الرصيد — ادفع بـ USDC / USDT / PYUSD، واحصل على رابط دفع
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# ← { "checkout_url": "https://…" }   # ادفع على السلسلة، يُضاف الرصيد تلقائيًا
# ٣. اطلب VPS — يُدفع من الرصيد (خذ slug + os_id من GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# ٤. اقرأ وصول SSH — كلمة مرور root لمرة واحدة تظهر هنا مرة واحدة
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "data": { "status":"active", "access": { "method":"ssh", "host":"…", "port":20123, "command":"ssh root@… -p 20123", "ssh_ready":true } } }

النقاط الطرفية الرئيسية

السطح الأساسي. افتح المستكشف التفاعلي لكل معامل واستجابة.

POST/auth/registerأنشئ حسابًا واحصل على رمز Bearer. دون كلمة مرور ودون خطوة بشرية.
GET/productsاعرض كل خطط VPS مع المواصفات والسعر وصور أنظمة التشغيل المدعومة.
POST/balance/topupأنشئ فاتورة شحن بالعملات المشفّرة؛ تُعيد رابط دفع. يُضاف الرصيد عند تأكيد السلسلة.
POST/ordersاطلب VPS. يدفع من الرصيد إن كان ممولًا، وإلا يُعيد فاتورة غير مدفوعة.
GET/services/{id}الحالة الكاملة + وصول SSH حيّ. تظهر كلمة مرور root لمرة واحدة هنا.
GET/balanceرصيد مدفوع مسبقًا والعملة.

اطّلع على كل نقطة طرفية ومعامل ومخطّط في المستكشف التفاعلي ←

لوكلاء الذكاء الاصطناعي

يمكن للوكيل الانتقال من لا شيء إلى خادم يعمل بمفرده — يكتشف، يدفع، يجهّز، ويقرأ SSH، كل ذلك عبر الـ API أو MCP.

MCP حيّ — لا مخطّط.

وجّه أي عميل MCP إلى https://mcp.eqvps.com/mcp (Streamable HTTP). تغطّي 47 أداة الاكتشاف والحساب والدفع والتحكم الكامل في VPS. الأدوات العامة: list_plans وregister_account وlogin؛ كل ما عداها يتطلب رمز Bearer.

التدفق الذاتي

1. register_account ← احصل على رمز Bearer
2. topup_balance ← ادفع رابط الدفع بـ USDC/USDT
3. order_vps ← جهّز من الرصيد
4. get_vps_status ← استعلم حتى يصبح نشطًا، اقرأ SSH (المضيف، المنفذ، الأمر، كلمة المرور لمرة واحدة)

موارد مقروءة آليًا

بيئات اختبار للكود لوكلاء الذكاء الاصطناعي

آلات Linux افتراضية مصغّرة ومعزولة تبدأ خلال نحو ثانية وتشغّل Python وNode.js وshell لوكلائك. تُحتسب بالثانية من رصيد العملات المشفّرة نفسه، بدءًا من $0.0165 للساعة. شغّلها عبر SDK أو MCP أو REST.

pip install eqvps          # Python
npm i @eqvps/sdk           # TypeScript / JavaScript
# MCP: create_sandbox -> run_code / exec_command -> kill_sandbox

بيئات اختبار الكود من ‏$0.0165 في الساعة ←توثيق بيئات الاختبار وSDK ←

الأخطاء

رموز حالة HTTP قياسية. تحمل الأجسام حقل message عند الفشل.

الحالةالمعنى
200 / 201موافق — نجح الطلب / أُنشئ المورد.
401رمز Bearer مفقود أو غير صالح.
403الإجراء غير مسموح — مثلاً الحساب أو الخادم موقوف.
404المورد غير موجود أو لا يتبع حسابك.
409تعارض في الحالة (مثلاً شحن غير مدفوع موجود بالفعل).
422خطأ تحقّق — راجع جسم الطلب.
429تجاوز الحدّ — تراجع وأعد المحاولة.

حدود المعدّل

الإجراءات الحساسة (الطلب، الشحن، إعادة تعيين كلمة المرور، إعادة التثبيت، وحدة التحكم) محدودة المعدّل لكل حساب. الأتمتة العادية تبقى ضمن الحدود بأريحية؛ عند 429، تراجع وأعد المحاولة.

ابدأ التطوير عليها الآن

خذ المواصفة، افتح المستكشف، أو اقرأ المرجع السردي الكامل مع إعداد MCP.