التوثيق/الاتصال/لوحتك الخاصة/ما تفعله اللوحة وما تفعله أنت·5 / 9
ما تفعله اللوحة وما تفعله أنت
اللوحة آلية عمل وليست واجهة جاهزة. لا نقرّر نحن مهام خدمتك التجارية ولا نتكيّف معها: واجهة العرض وصفحة العميل الخاصة ونظام CRM — تبنيها أنت بيدك أو بمساعدة الذكاء الاصطناعي.
ما الذي تحصل عليه
- سطر الأوامر
- الأمر veli على خادم اللوحة: تثبيت اللوحة، وإضافة العُقد بعنوان IP، وإنشاء العملاء، وإصدار الرموز وخطّافات الويب. لا حاجة إلى فتح شيء في المتصفح.
- واجهة API
- الإجراءات نفسها عبر HTTPS: العملاء والعُقد والمجموعات وحركة البيانات والأحداث. المخطط openapi.json هو ما يبني منه الذكاء الاصطناعي أو المبرمج عميلًا بأي لغة.
- خطّافات الويب
- تُبلغك اللوحة بالأحداث بنفسها: أُضيف عميل، أوشكت مدة على الانتهاء، أوشكت البيانات على النفاد، صمتت عقدة. يصل خادمك طلب موقَّع فيؤدّي ما عليه.
- MCP للذكاء الاصطناعي
- واجهة API نفسها أدواتٌ لـ Claude ووكلاء آخرين: «من تنتهي مدته هذا الأسبوع»، «مدّد لكل من وسمه vip». والصلاحيات يحدّدها الرمز.
ما الذي تفعله اللوحة
كل ما يتعلق بالوصول إلى VPN — بموثوقية ومن دون جهد منك.
- تحفظ العملاء: المدة والأجهزة والسرعة وحدّ البيانات وملاحظة ووسومك.
- تمنح كل عميل رابطًا واحدًا إلى كل خوادمك وصفحة اشتراك بسيطة بأزرار التطبيقات.
- توزّع قائمة العملاء على العُقد: يعمل العميل الجديد على كل العُقد خلال نصف دقيقة.
- تحسب البيانات والأجهزة، وتحتفظ بسجل الإجراءات، وتُبقي العملاء المحذوفين في سلة المحذوفات 30 يومًا.
- تُبلغ بالأحداث عبر خطّافات الويب والتغذية، وتردّ على وكيل الذكاء الاصطناعي عبر MCP.
ما الذي تفعله أنت
كل ما يتوقف على عملك يبقى بيدك، واللوحة لا تتدخّل فيه.
- الأسعار والدفع — قائمة أسعارك ونظام الدفع والاسترداد والضرائب. اللوحة لا تعرف إلا الأيام والأجهزة والبيانات — الأسعار والدفع عندك.
- الواجهة وصفحة العميل — موقع أو تطبيق يدفع فيه الشخص ويرى مدّته ويأخذ رابطه.
- طريقة عملك — من في فريقك يغيّر ماذا، وأي رسائل تصل العملاء، وأي تقارير تحتاجها.
- الدعم والسجلات — نظام CRM والطلبات وتاريخ المراسلات. يرتبط العميل بنظامك بمعرّف خارجي: رقم الطلب أو معرّف المستخدم في نظامك.
الرمز
أنشئ رمزًا بالصلاحيات والمدة التي تحتاجها — لموقع أو نظام لإدارة العملاء أو وكيل ذكاء اصطناعي — واحفظه بحيث لا يكلّف تسريبه شيئًا.
أنشئ الرمز في سطر الأوامر
على خادم اللوحة بصلاحية root: veli token add <الاسم> --rights read|clients|all. لا ينشئ الرموز وخطافات الويب إلا سطر الأوامر — لا رمز آخر ولا استدعاء API.
الاسم والصلاحيات والمدة
الاسم — من يستخدمه، مثل cabinet. الصلاحيات — read أو clients أو all (أدناه). والمدة اختيارية: --days 90، من 1 إلى 3650 يومًا؛ وبدون --days لا تنتهي مدة الرمز.
انسخ الرمز
يطبع سطر الأوامر الرمز مرة واحدة: انسخه إلى إعدادات نظامك. أضعته؟ ألغِه وأنشئ رمزًا جديدًا.
veli token add cabinet --rights clients --days 90veli 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}