التوثيق/الاتصال/لوحتك الخاصة/ما تفعله اللوحة وما تفعله أنت·5 / 9

ما تفعله اللوحة وما تفعله أنت

اللوحة آلية عمل وليست واجهة جاهزة. لا نقرّر نحن مهام خدمتك التجارية ولا نتكيّف معها: واجهة العرض وصفحة العميل الخاصة ونظام CRM — تبنيها أنت بيدك أو بمساعدة الذكاء الاصطناعي.

ما الذي تحصل عليه

سطر الأوامر
الأمر veli على خادم اللوحة: تثبيت اللوحة، وإضافة العُقد بعنوان IP، وإنشاء العملاء، وإصدار الرموز وخطّافات الويب. لا حاجة إلى فتح شيء في المتصفح.
واجهة API
الإجراءات نفسها عبر HTTPS: العملاء والعُقد والمجموعات وحركة البيانات والأحداث. المخطط openapi.json هو ما يبني منه الذكاء الاصطناعي أو المبرمج عميلًا بأي لغة.
خطّافات الويب
تُبلغك اللوحة بالأحداث بنفسها: أُضيف عميل، أوشكت مدة على الانتهاء، أوشكت البيانات على النفاد، صمتت عقدة. يصل خادمك طلب موقَّع فيؤدّي ما عليه.
‏MCP للذكاء الاصطناعي
واجهة API نفسها أدواتٌ لـ Claude ووكلاء آخرين: «من تنتهي مدته هذا الأسبوع»، «مدّد لكل من وسمه vip». والصلاحيات يحدّدها الرمز.

ما الذي تفعله اللوحة

كل ما يتعلق بالوصول إلى VPN — بموثوقية ومن دون جهد منك.

  • تحفظ العملاء: المدة والأجهزة والسرعة وحدّ البيانات وملاحظة ووسومك.
  • تمنح كل عميل رابطًا واحدًا إلى كل خوادمك وصفحة اشتراك بسيطة بأزرار التطبيقات.
  • توزّع قائمة العملاء على العُقد: يعمل العميل الجديد على كل العُقد خلال نصف دقيقة.
  • تحسب البيانات والأجهزة، وتحتفظ بسجل الإجراءات، وتُبقي العملاء المحذوفين في سلة المحذوفات 30 يومًا.
  • تُبلغ بالأحداث عبر خطّافات الويب والتغذية، وتردّ على وكيل الذكاء الاصطناعي عبر MCP.

ما الذي تفعله أنت

كل ما يتوقف على عملك يبقى بيدك، واللوحة لا تتدخّل فيه.

  • الأسعار والدفع — قائمة أسعارك ونظام الدفع والاسترداد والضرائب. اللوحة لا تعرف إلا الأيام والأجهزة والبيانات — الأسعار والدفع عندك.
  • الواجهة وصفحة العميل — موقع أو تطبيق يدفع فيه الشخص ويرى مدّته ويأخذ رابطه.
  • طريقة عملك — من في فريقك يغيّر ماذا، وأي رسائل تصل العملاء، وأي تقارير تحتاجها.
  • الدعم والسجلات — نظام CRM والطلبات وتاريخ المراسلات. يرتبط العميل بنظامك بمعرّف خارجي: رقم الطلب أو معرّف المستخدم في نظامك.

الرمز

أنشئ رمزًا بالصلاحيات والمدة التي تحتاجها — لموقع أو نظام لإدارة العملاء أو وكيل ذكاء اصطناعي — واحفظه بحيث لا يكلّف تسريبه شيئًا.

  1. أنشئ الرمز في سطر الأوامر

    على خادم اللوحة بصلاحية root: ‎veli token add <الاسم> --rights read|clients|all. لا ينشئ الرموز وخطافات الويب إلا سطر الأوامر — لا رمز آخر ولا استدعاء API.

  2. الاسم والصلاحيات والمدة

    الاسم — من يستخدمه، مثل cabinet. الصلاحيات — read أو clients أو all (أدناه). والمدة اختيارية: ‎--days 90، من 1 إلى 3650 يومًا؛ وبدون ‎--days لا تنتهي مدة الرمز.

  3. انسخ الرمز

    يطبع سطر الأوامر الرمز مرة واحدة: انسخه إلى إعدادات نظامك. أضعته؟ ألغِه وأنشئ رمزًا جديدًا.

رمز لمدة 90 يومًا — على خادم اللوحة
veli token add cabinet --rights clients --days 90
قائمة الرموز والإلغاء بالاسم
veli token list
veli token revoke cabinet
قراءة فقط
‎--rights read. يرى العملاء دون روابطهم والعُقد والحركة وتدفّق الأحداث. ولا يغيّر شيئًا
العملاء
‎--rights clients. يرى كل شيء، وروابط العملاء أيضًا، ويدير العملاء: يضيف ويمدّد ويعطّل ويفعّل ويغيّر الرابط ويفك ربط الأجهزة ويغيّر كثيرين معًا. ولا يحذف
الكل
‎--rights all. كل ما تستطيعه اللوحة: حذف العملاء وإدارة العُقد والمجموعات. عدا الرموز وخطافات الويب — لا ينشئها إلا سطر الأوامر
  • عنوان API هو عنوان اللوحة والمسار السري و‎/api/. يطبعه الأمر veli token add تحت الرمز نفسه (وكذلك تثبيت اللوحة). المسار مثل كلمة المرور: احفظه بجانب الرمز، لا في مستودع مفتوح.
  • يُرسَل الرمز في الترويسة ‎Authorization: Bearer veli_… — من خوادمك. لا تجيب اللوحة نصًّا برمجيًّا في صفحة داخل المتصفح.
  • لا تُنشأ الرموز وخطافات الويب عبر API، حتى برمز «الكل»: فالرمز المسرَّب لا يستطيع أن يلد رموزًا أخرى. لا ينشئها إلا سطر الأوامر.

الحدود

  • حتى 300 طلب في الدقيقة لكل رمز. كل رد يحمل RateLimit-Limit، وRateLimit-Remaining — كم بقي في هذه الدقيقة — وRateLimit-Reset — بعد كم ثانية تبدأ الدقيقة من جديد.
  • فوق الحد — الرد 429 wait مع Retry-After: 60. انتظر هذا العدد من الثواني وكرّر الطلب نفسه؛ ولـ POST — بمفتاح التكرار نفسه.

الطلب الأول

تحقّق من الرمز: يجيب GET me باسمه وصلاحياته ومدته، وتقول الترويسات كم طلبًا بقي في هذه الدقيقة.

على خادمك
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -si "$VELI/me" \
  -H "Authorization: Bearer $VELI_TOKEN"
الرد
HTTP/1.1 200 OK
content-type: application/json
ratelimit-limit: 300
ratelimit-remaining: 299
ratelimit-reset: 41

{"name": "cabinet", "token": true, "rights": "clients", "until": 0, "api": 1}