REST API · MCP

واجهة EQVPS API

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

OpenAPI 3.1MCP live · 26 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>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

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

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

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). تغطّي 26 أداة الاكتشاف والحساب والدفع والتحكم الكامل في VPS. الأدوات العامة: list_plans وregister_account وlogin؛ كل ما عداها يتطلب رمز Bearer.

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

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

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

agent.jsonملف آلي — الخطط والنقاط النهائية وحالة MCP.mcp.jsonبيان MCP — رابط الخادم وقائمة الأدوات.llms.txtدليل LLM موجز مع مثال شامل.llms-full.txtمرجع LLM موسّع.openapi.jsonمواصفة OpenAPI 3.1 (تُشغّل المستكشف).

الأخطاء

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

الحالةالمعنى

200 / 201موافق — نجح الطلب / أُنشئ المورد.

401رمز Bearer مفقود أو غير صالح.

403مُصادَق، لكنك لست مالك هذا المورد.

404المورد غير موجود.

409تعارض في الحالة (مثلاً شحن غير مدفوع موجود بالفعل).

422خطأ تحقّق — راجع جسم الطلب.

429تجاوز الحدّ — تراجع وأعد المحاولة.

حدود المعدّل

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

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

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

افتح المستكشف اقرأ الوثائق