التوثيق/الاتصال/لوحتك الخاصة/الاستدعاءات·6 / 9
الاستدعاءات
الجسم والرد بصيغة JSON، عدا رمز QR فهو SVG أو PNG. ويُرمَّز الاسم في العنوان كما في encodeURIComponent، ويمكن وضع معرّف العميل id بدل الاسم. اضغط على استدعاء لترى معاملاته وجسمه ورده وأمرًا جاهزًا. ومن الأسهل حفظ العنوان والرمز في متغيّرات:
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…الرمز والمخطط وMCP3
GET/meهذا الرمز: الاسم والصلاحيات والمدة وإصدار APIأي رمز
application/json{
"name": "cabinet",
"token": true,
"rights": "clients",
"until": 0,
"api": 1
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/me" \
-H "Authorization: Bearer $VELI_TOKEN"GET/openapi.jsonمخطط الواجهة كلها، OpenAPI 3.1قراءة
application/json{
"openapi": "3.1.0",
"info": { "title": "Veli panel API", "version": "1.12.0" },
"paths": {
"/clients": {
"get": {},
"post": {}
},
"…": {}
}
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/openapi.json" \
-H "Authorization: Bearer $VELI_TOKEN"POST/mcpاللوحة لوكيل الذكاء الاصطناعي عبر MCPأي رمز
application/json{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "clients_list",
"arguments": { "status": "soon" }
}
}application/json{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{ "type": "text", "text": "{\"clients\": [ … ], \"total\": 6}" }
]
}
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/mcp" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"clients_list","arguments":{"status":"soon"}}}'العملاء12
GET/clientsالعملاء: المرشّحات والترتيب والصفحاتقراءة
المعاملات
externalفي الاستعلام- معرّف خارجي — العملاء الذين يحملونه فقط؛ و«:» في العنوان تُكتب %3A
tagفي الاستعلام- وسم — العملاء الذين يحملونه فقط
statusفي الاستعلام- الحالات مفصولة بفواصل: on وsoon وlimit وoff وpaused وwaiting
groupفي الاستعلام- المجموعة؛ والقيمة الفارغة — العملاء بلا مجموعة
qفي الاستعلام- كلمة في الاسم أو الملاحظة أو جهة الاتصال أو المعرّف الخارجي، دون تمييز حالة الأحرف
until_beforeفي الاستعلام- نهاية المدة قبل هذا الوقت، بتوقيت unix؛ ولا يدخل من بلا نهاية
until_afterفي الاستعلام- نهاية المدة بعد هذا الوقت، بتوقيت unix؛ ولا يدخل من بلا نهاية
changed_sinceفي الاستعلام- عُدّل يدويًا أو بواسطة النظام منذ هذا الوقت — للمطابقة مع قاعدة بياناتك
devicesفي الاستعلام- القيمة none — لا أجهزة، وsome — توجد أجهزة، وfull — كل الأماكن مشغولة
used_overفي الاستعلام- استُهلك ما لا يقل عن هذه النسبة من الحد، %؛ ولا يدخل العملاء بلا حد
seen_beforeفي الاستعلام- لم يأخذ التطبيق الاشتراك منذ هذا الوقت — أو لم يأخذه قط
sortفي الاستعلام- الترتيب حسب name أو until أو added أو used أو changed؛ و«-» في أوله — بالعكس
limitفي الاستعلام- عدد العملاء في الصفحة، 1–1000؛ ودونه — الكل دفعة واحدة
cursorفي الاستعلام- قيمة next من الصفحة السابقة
application/json{
"at": 1793754000,
"clients": [
{
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null }
}
],
"total": 412,
"next": "eyJrIjoxNzk0MDAwMDAwfQ"
}حقول العميل
id- يبدأ بـ c_ ثم 12 حرفًا — وهو دائم: إعادة التسمية لا تغيّره. يعمل في المسار بدل الاسم: clients/c_Ab3dE5fG7hJ9. احفظه لديك، لا الاسم
name- الاسم، من 1 إلى 40 حرفًا، ولكل عميل اسمه؛ ولا يجوز شكل c_ مع 12 حرفًا — فهكذا يبدو id
external- المعرّف الخارجي — معرّفك للعميل؛ فارغ — لا يوجد. وهو ليس فريدًا: قد يشتري شخص واحد اشتراكين، لذا يعيد البحث قائمة
tags- الوسوم
status- القيمة on أو soon أو limit أو off أو paused أو waiting — أعلاه
until- نهاية المدة بتوقيت unix؛ 0 — بلا نهاية أو المدة ما زالت تنتظر أول اتصال
wait, first- كم ثانية من المدة تبدأ مع أول اتصال (0 — لا انتظار)؛ ومتى أخذ التطبيق الاشتراك أول مرة (0 — لم يحدث بعد)
left- المتبقي: days وbytes؛ وnull — بلا مدة وبلا حد
devices, held, veli- عدد الأجهزة المسموح بها، والمشغولة بكل التطبيقات، ومنها أجهزة Veli
speed- سرعة Veli في كل اتجاه بالميغابت/ث؛ 0 — بلا حد
limit, reset, used, next- حد البيانات بالبايت (0 — بلا حد)، وإعادة التعيين — never أو day أو week أو month بتوقيت UTC، والمستهلك خلال الفترة، وبداية الفترة التالية
group- المجموعة؛ فارغ — بلا مجموعة
bytes- البيانات طوال الوقت
seen, changed- آخر طلب للاشتراك من التطبيق (بدقة 10 دقائق، و0 — لم يحدث)؛ وآخر تغيير يدوي أو من النظام
note, contact, added- الملاحظة وجهة الاتصال ووقت الإضافة
الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients?status=on,soon&sort=-until&limit=100" \
-H "Authorization: Bearer $VELI_TOKEN"POST/clients/findالعميل حسب الرابط أو الجهاز؛ رمز القراءة فقط لا يرى الرابط في الردقراءة
application/json{ "link": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb" }application/json{
"at": 1793754000,
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null },
"disabled": false,
"link": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"list": [
{
"id": "vk_3fA9c2…",
"kind": "veli",
"os": "Android",
"added": 1793750520,
"bytes": 1073741824
},
{
"id": "a1b2c3d4e5f6",
"kind": "app",
"os": "iOS",
"added": 1793751000
}
],
"lines": [
{
"node": "de-1",
"kind": "Reality",
"line": "vless://…@203.0.113.10:8443?security=reality…#de-1 · Reality"
}
],
"meta": { "order": "88123" },
"page": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"apps": {
"Happ": "happ://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"v2rayNG": "v2rayng://install-sub?url=…",
"Hiddify": "hiddify://import/…",
"…": "…",
"Veli": "veli://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb"
}
}حقول العميل
id- يبدأ بـ c_ ثم 12 حرفًا — وهو دائم: إعادة التسمية لا تغيّره. يعمل في المسار بدل الاسم: clients/c_Ab3dE5fG7hJ9. احفظه لديك، لا الاسم
name- الاسم، من 1 إلى 40 حرفًا، ولكل عميل اسمه؛ ولا يجوز شكل c_ مع 12 حرفًا — فهكذا يبدو id
external- المعرّف الخارجي — معرّفك للعميل؛ فارغ — لا يوجد. وهو ليس فريدًا: قد يشتري شخص واحد اشتراكين، لذا يعيد البحث قائمة
tags- الوسوم
status- القيمة on أو soon أو limit أو off أو paused أو waiting — أعلاه
until- نهاية المدة بتوقيت unix؛ 0 — بلا نهاية أو المدة ما زالت تنتظر أول اتصال
wait, first- كم ثانية من المدة تبدأ مع أول اتصال (0 — لا انتظار)؛ ومتى أخذ التطبيق الاشتراك أول مرة (0 — لم يحدث بعد)
left- المتبقي: days وbytes؛ وnull — بلا مدة وبلا حد
devices, held, veli- عدد الأجهزة المسموح بها، والمشغولة بكل التطبيقات، ومنها أجهزة Veli
speed- سرعة Veli في كل اتجاه بالميغابت/ث؛ 0 — بلا حد
limit, reset, used, next- حد البيانات بالبايت (0 — بلا حد)، وإعادة التعيين — never أو day أو week أو month بتوقيت UTC، والمستهلك خلال الفترة، وبداية الفترة التالية
group- المجموعة؛ فارغ — بلا مجموعة
bytes- البيانات طوال الوقت
seen, changed- آخر طلب للاشتراك من التطبيق (بدقة 10 دقائق، و0 — لم يحدث)؛ وآخر تغيير يدوي أو من النظام
note, contact, added- الملاحظة وجهة الاتصال ووقت الإضافة
at- وقت إعداد الرد، بتوقيت unix
link- رابط الاشتراك — وهو سرّ: يُعطى للعميل وحده
page- صفحة الاشتراك للمتصفح، مع أزرار التطبيقات
apps- روابط «إضافة إلى …» لكل تطبيق
list- الأجهزة: id، وkind — veli (مفتاح Veli) أو app (معرّف HWID لتطبيق آخر)، وos، وadded؛ ولجهاز Veli أيضًا bytes
lines- أسطر البروتوكولات العادية حسب العقدة: node وkind وline
meta- حقول نظامك
disabled- القيمة true — العميل موقوف
الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/find" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"link":"https://panel.example.com/s/kV0pX7wQ2mLr9sTb"}'POST/clientsإضافة عميلالعملاء
application/json{
"name": "order-88123",
"days": 30,
"change": {
"devices": 3,
"external": "88123",
"tags": ["paid", "month"],
"meta": { "order": "88123", "source": "shop" }
}
}حقول change — كلٌّ منها اختياري
days- التمديد بهذا العدد من الأيام: من نهاية المدة، وللمنتهي — من الآن؛ وما دون الصفر — تقصير. وللمنتظر أول اتصال — انتظار أطول أو أقصر. أيام العميل الجديد بجانب change، وnull — بلا نهاية. ±1–36500
until- نهاية المدة بالضبط، بتوقيت unix؛ 0 — بلا نهاية. لا يُستخدم مع days. وإن كان في الماضي — تنتهي المدة الآن
start- القيمة first_use — تبدأ المدة مع أول طلب للاشتراك من التطبيق؛ وnow — يبدأ المنتظر مدته الآن
name- اسم جديد — لعميل واحد فقط؛ ويبقى id والرابط والأجهزة والبيانات
disabled- القيمة true — تعطيل: لا يُفتح الرابط، وتُزال الأجهزة من العُقد، والمدة تستمر؛ وfalse — تفعيل
relink- القيمة true — رابط جديد: يتوقف القديم، وتصبح حسابات البروتوكولات العادية جديدة، وتبقى أجهزة Veli
devices- عدد الأجهزة المسموح بها، من 1 إلى 100
speed- بالميغابت/ث، 0–100000؛ 0 — بلا حد
limit, reset, zero- حد البيانات بالبايت، وإعادة التعيين، وtrue — بدء العدّ من الصفر
group- المجموعة باسمها؛ فارغ — بلا مجموعة
external- المعرّف الخارجي، حتى 128 حرفًا؛ فارغ — حذفه
tags- الوسوم — القائمة كلها من جديد: حتى 20، وكل منها حتى 32 حرفًا
tags_add, tags_remove- إضافة وسوم وإزالتها، ويبقى الباقي — مناسب لتغيير كثيرين معًا
meta- حقول نظامك — كلها من جديد: حتى 20؛ المفتاح أحرف لاتينية وأرقام و _ . -، حتى 40 حرفًا؛ والقيمة حتى 500
note, contact- ملاحظة حتى 300 حرف، وجهة اتصال حتى 100
القيمة الأطول من اللازم لا تُقتطع، بل تعطي الخطأ bad مع الحقل والحد — {"error": "bad", "field": "change.devices", "max": 100}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.
application/json{
"done": 1,
"client": {
"at": 1793754000,
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null },
"disabled": false,
"link": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"list": [
{
"id": "vk_3fA9c2…",
"kind": "veli",
"os": "Android",
"added": 1793750520,
"bytes": 1073741824
},
{
"id": "a1b2c3d4e5f6",
"kind": "app",
"os": "iOS",
"added": 1793751000
}
],
"lines": [
{
"node": "de-1",
"kind": "Reality",
"line": "vless://…@203.0.113.10:8443?security=reality…#de-1 · Reality"
}
],
"meta": { "order": "88123" },
"page": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"apps": {
"Happ": "happ://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"v2rayNG": "v2rayng://install-sub?url=…",
"Hiddify": "hiddify://import/…",
"…": "…",
"Veli": "veli://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb"
}
}
}حقول العميل
id- يبدأ بـ c_ ثم 12 حرفًا — وهو دائم: إعادة التسمية لا تغيّره. يعمل في المسار بدل الاسم: clients/c_Ab3dE5fG7hJ9. احفظه لديك، لا الاسم
name- الاسم، من 1 إلى 40 حرفًا، ولكل عميل اسمه؛ ولا يجوز شكل c_ مع 12 حرفًا — فهكذا يبدو id
external- المعرّف الخارجي — معرّفك للعميل؛ فارغ — لا يوجد. وهو ليس فريدًا: قد يشتري شخص واحد اشتراكين، لذا يعيد البحث قائمة
tags- الوسوم
status- القيمة on أو soon أو limit أو off أو paused أو waiting — أعلاه
until- نهاية المدة بتوقيت unix؛ 0 — بلا نهاية أو المدة ما زالت تنتظر أول اتصال
wait, first- كم ثانية من المدة تبدأ مع أول اتصال (0 — لا انتظار)؛ ومتى أخذ التطبيق الاشتراك أول مرة (0 — لم يحدث بعد)
left- المتبقي: days وbytes؛ وnull — بلا مدة وبلا حد
devices, held, veli- عدد الأجهزة المسموح بها، والمشغولة بكل التطبيقات، ومنها أجهزة Veli
speed- سرعة Veli في كل اتجاه بالميغابت/ث؛ 0 — بلا حد
limit, reset, used, next- حد البيانات بالبايت (0 — بلا حد)، وإعادة التعيين — never أو day أو week أو month بتوقيت UTC، والمستهلك خلال الفترة، وبداية الفترة التالية
group- المجموعة؛ فارغ — بلا مجموعة
bytes- البيانات طوال الوقت
seen, changed- آخر طلب للاشتراك من التطبيق (بدقة 10 دقائق، و0 — لم يحدث)؛ وآخر تغيير يدوي أو من النظام
note, contact, added- الملاحظة وجهة الاتصال ووقت الإضافة
at- وقت إعداد الرد، بتوقيت unix
link- رابط الاشتراك — وهو سرّ: يُعطى للعميل وحده
page- صفحة الاشتراك للمتصفح، مع أزرار التطبيقات
apps- روابط «إضافة إلى …» لكل تطبيق
list- الأجهزة: id، وkind — veli (مفتاح Veli) أو app (معرّف HWID لتطبيق آخر)، وos، وadded؛ ولجهاز Veli أيضًا bytes
lines- أسطر البروتوكولات العادية حسب العقدة: node وkind وline
meta- حقول نظامك
disabled- القيمة true — العميل موقوف
الأخطاء
400 name- الاسم فارغ أو أطول من 40 حرفًا أو فيه محارف تحكّم أو بشكل c_ مع 12 حرفًا أو كلمة من كلمات API: bulk وfind
400 taken- هذا الاسم مستخدم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
409 idempotency- مفتاح Idempotency-Key هذا استُخدم لطلب آخر. المفتاح لعملية واحدة: للتمديد مفتاح وللإنشاء مفتاح آخر
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"name":"order-88123","days":30,"change":{"devices":3,"external":"88123","tags":["paid","month"],"meta":{"order":"88123","source":"shop"}}}'GET/clients/{name}العميل كاملًا: الرابط وأزرار التطبيقات والأجهزة والحقول. رمز القراءة فقط لا يرى الرابط ولا الأزرارقراءة
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{
"at": 1793754000,
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null },
"disabled": false,
"link": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"list": [
{
"id": "vk_3fA9c2…",
"kind": "veli",
"os": "Android",
"added": 1793750520,
"bytes": 1073741824
},
{
"id": "a1b2c3d4e5f6",
"kind": "app",
"os": "iOS",
"added": 1793751000
}
],
"lines": [
{
"node": "de-1",
"kind": "Reality",
"line": "vless://…@203.0.113.10:8443?security=reality…#de-1 · Reality"
}
],
"meta": { "order": "88123" },
"page": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"apps": {
"Happ": "happ://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"v2rayNG": "v2rayng://install-sub?url=…",
"Hiddify": "hiddify://import/…",
"…": "…",
"Veli": "veli://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb"
}
}حقول العميل
id- يبدأ بـ c_ ثم 12 حرفًا — وهو دائم: إعادة التسمية لا تغيّره. يعمل في المسار بدل الاسم: clients/c_Ab3dE5fG7hJ9. احفظه لديك، لا الاسم
name- الاسم، من 1 إلى 40 حرفًا، ولكل عميل اسمه؛ ولا يجوز شكل c_ مع 12 حرفًا — فهكذا يبدو id
external- المعرّف الخارجي — معرّفك للعميل؛ فارغ — لا يوجد. وهو ليس فريدًا: قد يشتري شخص واحد اشتراكين، لذا يعيد البحث قائمة
tags- الوسوم
status- القيمة on أو soon أو limit أو off أو paused أو waiting — أعلاه
until- نهاية المدة بتوقيت unix؛ 0 — بلا نهاية أو المدة ما زالت تنتظر أول اتصال
wait, first- كم ثانية من المدة تبدأ مع أول اتصال (0 — لا انتظار)؛ ومتى أخذ التطبيق الاشتراك أول مرة (0 — لم يحدث بعد)
left- المتبقي: days وbytes؛ وnull — بلا مدة وبلا حد
devices, held, veli- عدد الأجهزة المسموح بها، والمشغولة بكل التطبيقات، ومنها أجهزة Veli
speed- سرعة Veli في كل اتجاه بالميغابت/ث؛ 0 — بلا حد
limit, reset, used, next- حد البيانات بالبايت (0 — بلا حد)، وإعادة التعيين — never أو day أو week أو month بتوقيت UTC، والمستهلك خلال الفترة، وبداية الفترة التالية
group- المجموعة؛ فارغ — بلا مجموعة
bytes- البيانات طوال الوقت
seen, changed- آخر طلب للاشتراك من التطبيق (بدقة 10 دقائق، و0 — لم يحدث)؛ وآخر تغيير يدوي أو من النظام
note, contact, added- الملاحظة وجهة الاتصال ووقت الإضافة
at- وقت إعداد الرد، بتوقيت unix
link- رابط الاشتراك — وهو سرّ: يُعطى للعميل وحده
page- صفحة الاشتراك للمتصفح، مع أزرار التطبيقات
apps- روابط «إضافة إلى …» لكل تطبيق
list- الأجهزة: id، وkind — veli (مفتاح Veli) أو app (معرّف HWID لتطبيق آخر)، وos، وadded؛ ولجهاز Veli أيضًا bytes
lines- أسطر البروتوكولات العادية حسب العقدة: node وkind وline
meta- حقول نظامك
disabled- القيمة true — العميل موقوف
الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123" \
-H "Authorization: Bearer $VELI_TOKEN"POST/clients/{name}تغيير: تمديد، إيقاف، إعادة تسمية، رابط جديد، الحد، الحقولالعملاء
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{
"change": {
"days": 30,
"devices": 5,
"tags_add": ["vip"]
}
}حقول change — كلٌّ منها اختياري
days- التمديد بهذا العدد من الأيام: من نهاية المدة، وللمنتهي — من الآن؛ وما دون الصفر — تقصير. وللمنتظر أول اتصال — انتظار أطول أو أقصر. أيام العميل الجديد بجانب change، وnull — بلا نهاية. ±1–36500
until- نهاية المدة بالضبط، بتوقيت unix؛ 0 — بلا نهاية. لا يُستخدم مع days. وإن كان في الماضي — تنتهي المدة الآن
start- القيمة first_use — تبدأ المدة مع أول طلب للاشتراك من التطبيق؛ وnow — يبدأ المنتظر مدته الآن
name- اسم جديد — لعميل واحد فقط؛ ويبقى id والرابط والأجهزة والبيانات
disabled- القيمة true — تعطيل: لا يُفتح الرابط، وتُزال الأجهزة من العُقد، والمدة تستمر؛ وfalse — تفعيل
relink- القيمة true — رابط جديد: يتوقف القديم، وتصبح حسابات البروتوكولات العادية جديدة، وتبقى أجهزة Veli
devices- عدد الأجهزة المسموح بها، من 1 إلى 100
speed- بالميغابت/ث، 0–100000؛ 0 — بلا حد
limit, reset, zero- حد البيانات بالبايت، وإعادة التعيين، وtrue — بدء العدّ من الصفر
group- المجموعة باسمها؛ فارغ — بلا مجموعة
external- المعرّف الخارجي، حتى 128 حرفًا؛ فارغ — حذفه
tags- الوسوم — القائمة كلها من جديد: حتى 20، وكل منها حتى 32 حرفًا
tags_add, tags_remove- إضافة وسوم وإزالتها، ويبقى الباقي — مناسب لتغيير كثيرين معًا
meta- حقول نظامك — كلها من جديد: حتى 20؛ المفتاح أحرف لاتينية وأرقام و _ . -، حتى 40 حرفًا؛ والقيمة حتى 500
note, contact- ملاحظة حتى 300 حرف، وجهة اتصال حتى 100
القيمة الأطول من اللازم لا تُقتطع، بل تعطي الخطأ bad مع الحقل والحد — {"error": "bad", "field": "change.devices", "max": 100}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.
application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
400 taken- هذا الاسم مستخدم
409 idempotency- مفتاح Idempotency-Key هذا استُخدم لطلب آخر. المفتاح لعملية واحدة: للتمديد مفتاح وللإنشاء مفتاح آخر
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"change":{"days":30,"devices":5,"tags_add":["vip"]}}'GET/clients/{name}/qrرمز QR للرابط: SVG أو PNGالعملاء
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
formatفي الاستعلام- الصيغة svg أو png؛ ودونه — svg
sizeفي الاستعلام- ضلع صورة PNG بالنقاط، 128–2048؛ ودونه — 512
ofفي الاستعلام- القيمة veli — رمز QR لرابط «إضافة إلى Veli» بدل رابط الاشتراك
image/svg+xml<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 41 41" shape-rendering="crispEdges">
<path fill="#fff" d="M0 0h41v41H0z"/>
<path d="M4 4h7v1H4z…"/>
</svg>الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/qr?format=svg" \
-H "Authorization: Bearer $VELI_TOKEN" -o qr.svgGET/clients/{name}/statsحركة بيانات العميل يومًا بيومقراءة
التواريخ بتوقيت UTC، من الأقدم إلى اليوم؛ والبايتات في الاتجاهين.
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
daysفي الاستعلام- عن كم يومًا: 7 أو 30 أو 90؛ ودونه — 30
application/json{
"days": ["2026-10-29", "2026-10-30", "2026-10-31", "2026-11-01", "2026-11-02", "2026-11-03", "2026-11-04"],
"bytes": [0, 52428800, 104857600, 314572800, 209715200, 419430400, 188743680]
}الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/stats?days=7" \
-H "Authorization: Bearer $VELI_TOKEN"GET/clients/{name}/historyسجل العميلقراءة
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{
"at": 1793754000,
"client": "order-88123",
"history": [
{
"at": 1793751000,
"kind": "event",
"event": "device.added",
"os": "iOS",
"app": "Happ"
},
{
"at": 1793750460,
"kind": "admin",
"what": "client order-88123",
"by": "cabinet",
"token": true,
"fields": ["days"]
},
{
"at": 1793750400,
"kind": "admin",
"what": "clients add",
"by": "cabinet",
"token": true
}
]
}الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/history" \
-H "Authorization: Bearer $VELI_TOKEN"GET/clients/{name}/diagnosisلماذا قد لا يتصل العميلقراءة
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{
"at": 1793754000,
"ok": false,
"checks": [
{ "code": "devices_full", "level": "warn", "action": "unbind", "n": 3 },
{ "code": "nodes_some_down", "level": "info", "n": 1 }
],
"last": { "at": 1793753700, "app": "Happ", "code": 403 }
}الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/diagnosis" \
-H "Authorization: Bearer $VELI_TOKEN"POST/clients/{name}/unbindفكّ ربط جهازالعملاء
الحقل device — معرّف من list العميل. ويتحرر المكان فورًا: يمكن ربط جهاز آخر عليه.
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{ "device": "a1b2c3d4e5f6" }application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/unbind" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"device":"a1b2c3d4e5f6"}'POST/clients/bulkتغيير كثيرين دفعة واحدة — الكل أو لا أحدالعملاء
application/json{
"filter": {
"status": ["on", "soon"],
"tag": "paid"
},
"change": { "days": 3 },
"dry": true
}حقول change — كلٌّ منها اختياري
days- التمديد بهذا العدد من الأيام: من نهاية المدة، وللمنتهي — من الآن؛ وما دون الصفر — تقصير. وللمنتظر أول اتصال — انتظار أطول أو أقصر. أيام العميل الجديد بجانب change، وnull — بلا نهاية. ±1–36500
until- نهاية المدة بالضبط، بتوقيت unix؛ 0 — بلا نهاية. لا يُستخدم مع days. وإن كان في الماضي — تنتهي المدة الآن
start- القيمة first_use — تبدأ المدة مع أول طلب للاشتراك من التطبيق؛ وnow — يبدأ المنتظر مدته الآن
name- اسم جديد — لعميل واحد فقط؛ ويبقى id والرابط والأجهزة والبيانات
disabled- القيمة true — تعطيل: لا يُفتح الرابط، وتُزال الأجهزة من العُقد، والمدة تستمر؛ وfalse — تفعيل
relink- القيمة true — رابط جديد: يتوقف القديم، وتصبح حسابات البروتوكولات العادية جديدة، وتبقى أجهزة Veli
devices- عدد الأجهزة المسموح بها، من 1 إلى 100
speed- بالميغابت/ث، 0–100000؛ 0 — بلا حد
limit, reset, zero- حد البيانات بالبايت، وإعادة التعيين، وtrue — بدء العدّ من الصفر
group- المجموعة باسمها؛ فارغ — بلا مجموعة
external- المعرّف الخارجي، حتى 128 حرفًا؛ فارغ — حذفه
tags- الوسوم — القائمة كلها من جديد: حتى 20، وكل منها حتى 32 حرفًا
tags_add, tags_remove- إضافة وسوم وإزالتها، ويبقى الباقي — مناسب لتغيير كثيرين معًا
meta- حقول نظامك — كلها من جديد: حتى 20؛ المفتاح أحرف لاتينية وأرقام و _ . -، حتى 40 حرفًا؛ والقيمة حتى 500
note, contact- ملاحظة حتى 300 حرف، وجهة اتصال حتى 100
القيمة الأطول من اللازم لا تُقتطع، بل تعطي الخطأ bad مع الحقل والحد — {"error": "bad", "field": "change.devices", "max": 100}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.
application/json{
"done": 0,
"matched": 412,
"names": ["order-88123", "order-88124", "…"]
}الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
409 idempotency- مفتاح Idempotency-Key هذا استُخدم لطلب آخر. المفتاح لعملية واحدة: للتمديد مفتاح وللإنشاء مفتاح آخر
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/bulk" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"filter":{"status":["on","soon"],"tag":"paid"},"change":{"days":3},"dry":true}'POST/clients/{name}/removeحذف عميل — إلى سلة المحذوفات لمدة 30 يومًاالكل
المعاملات
nameفي المسار- اسم العميل أو معرّفه id
application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/clients/order-88123/remove" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTسلة المحذوفات4
GET/trashالعملاء المحذوفونقراءة
application/json{
"at": 1793754000,
"days": 30,
"clients": [
{
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"gone": 1793751100,
"purge": 1796343100,
"until": 1796342400,
"external": "88123",
"tags": ["paid"],
"contact": "@anna",
"note": "",
"devices": 2,
"taken": false
}
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/trash" \
-H "Authorization: Bearer $VELI_TOKEN"POST/trash/{id}/restoreاستعادة من السلةالكل
بالرابط والأجهزة نفسها. الاسم مشغول — taken. والرد هو العميل كاملًا.
المعاملات
idفي المسار- معرّف العميل id في سلة المحذوفات
application/json{
"done": 1,
"client": {
"at": 1793754000,
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null },
"disabled": false,
"link": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"list": [
{
"id": "vk_3fA9c2…",
"kind": "veli",
"os": "Android",
"added": 1793750520,
"bytes": 1073741824
},
{
"id": "a1b2c3d4e5f6",
"kind": "app",
"os": "iOS",
"added": 1793751000
}
],
"lines": [
{
"node": "de-1",
"kind": "Reality",
"line": "vless://…@203.0.113.10:8443?security=reality…#de-1 · Reality"
}
],
"meta": { "order": "88123" },
"page": "https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"apps": {
"Happ": "happ://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb",
"v2rayNG": "v2rayng://install-sub?url=…",
"Hiddify": "hiddify://import/…",
"…": "…",
"Veli": "veli://add/https://panel.example.com/s/kV0pX7wQ2mLr9sTb"
}
}
}الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 taken- هذا الاسم مستخدم
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/trash/c_Ab3dE5fG7hJ9/restore" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTPOST/trash/{id}/removeحذف من السلة نهائيًاالكل
لا يمكن استعادته بعد ذلك.
المعاملات
idفي المسار- معرّف العميل id في سلة المحذوفات
application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/trash/c_Ab3dE5fG7hJ9/remove" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTPOST/trash/clearإفراغ السلةالكل
كل المحذوفين — نهائيًا. done — كم كانوا.
application/json{ "done": 4 }الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/trash/clear" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTموجز الأحداث1
GET/eventsموجز الأحداث: لنظام بلا عنوان خاصقراءة
المعاملات
afterفي الاستعلام- قيمة last من الرد السابق؛ و0 — من بداية الموجز
waitفي الاستعلام- كم ثانية ينتظر إن لم تكن هناك أحداث جديدة: 0–25
typesفي الاستعلام- هذه الأحداث فقط، مفصولة بفواصل
limitفي الاستعلام- عدد الأحداث في المرة، 1–1000؛ ودونه — 100
application/json{
"at": 1793754000,
"events": [
{
"seq": 1041,
"id": "evt_mV3xQ8rT2kLp",
"event": "client.added",
"at": 1793750460,
"data": {
"client": {
"id": "c_Ab3dE5fG7hJ9",
"name": "order-88123",
"changed": 1793750460,
"seen": 1793753400,
"note": "",
"contact": "@anna",
"until": 1796342400,
"devices": 3,
"held": 2,
"veli": 1,
"speed": 0,
"added": 1793750400,
"bytes": 1288490188,
"status": "on",
"group": "",
"limit": 0,
"reset": "never",
"used": 0,
"next": 0,
"external": "88123",
"tags": ["paid", "month"],
"wait": 0,
"first": 1793750520,
"left": { "days": 30, "bytes": null }
}
}
}
],
"last": 1041
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/events?after=1040&wait=25&types=client.added,client.expired&limit=100" \
-H "Authorization: Bearer $VELI_TOKEN"النظرة العامة والإحصاءات والأجهزة5
GET/overviewالملخّص: العملاء والأجهزة والعُقد والحركة والأحداثقراءة
application/json{
"at": 1793754000,
"clients": {
"total": 148,
"active": 131,
"expired": 9,
"expiring": 6,
"limited": 1,
"paused": 1
},
"devices": { "veli": 96, "other": 187 },
"online": 74,
"traffic": 5841203482112,
"top": [
{ "name": "order-88123", "bytes": 41231564800 }
],
"nodes": [
{
"name": "de-1",
"host": "203.0.113.10",
"reported": "203.0.113.10",
"address": "",
"port": 443,
"up": true,
"seen": 1793753990,
"connected": 31,
"protocols": ["Veli", "Reality"],
"ports": [
{ "kind": "veli", "label": "Veli", "port": 443 },
{ "kind": "reality", "label": "Reality", "port": 8443 }
],
"version": "1.8.0",
"behind": false,
"disabled": false,
"main": false,
"added": 1791158400,
"devices": 58,
"traffic": 912680550400
}
],
"events": [
{ "kind": "expiring", "count": 6 },
{ "kind": "silent", "node": "nl-1", "since": 1793753400 }
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/overview" \
-H "Authorization: Bearer $VELI_TOKEN"GET/statsحركة بيانات اللوحة يومًا بيوم: إجمالًا وحسب العقدةقراءة
المعاملات
daysفي الاستعلام- عن كم يومًا: 7 أو 30 أو 90؛ ودونه — 30
application/json{
"at": 1793754000,
"days": ["2026-10-29", "2026-10-30", "2026-10-31", "2026-11-01", "2026-11-02", "2026-11-03", "2026-11-04"],
"total": [612368384000, 640942080000, 702545920000, 655360000000, 598933504000, 683671552000, 214748364800],
"nodes": [
{
"name": "de-1",
"bytes": [311385128960, 322122547200, 354334801920, 330712481792, 300647710720, 343597383680, 107374182400]
}
],
"top": [
{ "name": "order-88123", "bytes": 1288490188 }
],
"online": 74
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/stats?days=7" \
-H "Authorization: Bearer $VELI_TOKEN"GET/devicesكل أجهزة كل العملاءقراءة
application/json{
"at": 1793754000,
"devices": [
{
"id": "vk_3fA9c2…",
"client": "order-88123",
"kind": "veli",
"app": "Veli",
"os": "Android",
"added": 1793750520,
"seen": 1793753940,
"bytes": 1073741824
},
{
"id": "a1b2c3d4e5f6",
"client": "order-88123",
"kind": "app",
"app": "Happ",
"os": "iOS",
"added": 1793751000,
"seen": 1793753700
}
],
"by_app": { "Veli": 96, "Happ": 120, "v2rayN": 67 },
"by_os": { "Android": 140, "iOS": 80, "Windows": 63 }
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/devices" \
-H "Authorization: Bearer $VELI_TOKEN"GET/requestsآخر طلبات الاشتراكقراءة
المعاملات
clientفي الاستعلام- طلبات هذا العميل فقط
limitفي الاستعلام- كم من الأخيرة؛ ودونه — 200، ولا أكثر من 2000
application/json{
"at": 1793754000,
"requests": [
{
"at": 1793753700,
"client": "order-88123",
"ip": "198.51.100.7",
"app": "Happ",
"code": 200,
"page": false
}
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/requests?client=order-88123&limit=50" \
-H "Authorization: Bearer $VELI_TOKEN"GET/logسجل الإجراءات: ماذا فعلت الرموز وسطر الأوامر ومن أينالكل
المعاملات
whoفي الاستعلام- اسم الرمز أو root — أفعاله فقط
whatفي الاستعلام- clients أو nodes أو groups أو integrations أو plugins أو backups
qفي الاستعلام- كلمات في السجل، مثل اسم عميل
beforeفي الاستعلام- أقدم من هذا، بوقت unix: الصفحة التالية
afterفي الاستعلام- أحدث من هذا، بوقت unix
application/json{
"at": 1793754000,
"more": false,
"names": ["root", "cabinet"],
"kept": 20000,
"entries": [
{
"at": 1793753700,
"name": "cabinet",
"token": true,
"from": "198.51.100.7",
"what": "client add order-88123",
"kind": "clients",
"names": ["order-88123"],
"fields": []
},
{
"at": 1793752200,
"name": "root",
"token": false,
"from": null,
"what": "token add cabinet clients",
"kind": "integrations",
"names": [],
"fields": []
}
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/log?who=cabinet&what=clients" \
-H "Authorization: Bearer $VELI_TOKEN"العُقد6
GET/nodesكل العُقدقراءة
application/json{
"at": 1793754000,
"nodes": [
{
"name": "de-1",
"host": "203.0.113.10",
"reported": "203.0.113.10",
"address": "",
"port": 443,
"up": true,
"seen": 1793753990,
"connected": 31,
"protocols": ["Veli", "Reality"],
"ports": [
{ "kind": "veli", "label": "Veli", "port": 443 },
{ "kind": "reality", "label": "Reality", "port": 8443 }
],
"version": "1.8.0",
"behind": false,
"disabled": false,
"main": false,
"added": 1791158400,
"devices": 58,
"traffic": 912680550400
}
],
"kinds": [
{ "kind": "reality", "label": "Reality", "port": 8443, "udp": false },
{
"kind": "shadowsocks",
"label": "Shadowsocks",
"port": 8388,
"udp": false
},
{ "kind": "hysteria2", "label": "Hysteria2", "port": 8443, "udp": true }
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes" \
-H "Authorization: Bearer $VELI_TOKEN"POST/nodesإضافة عقدةالكل
application/json{ "name": "de-2", "protocols": "reality,shadowsocks:9388" }application/json{
"command": "sudo veli panel attach https://panel.example.com --protocols reality,shadowsocks:9388 --token -",
"token": "Hq3Zr8vT1kLm…"
}الأخطاء
400 name- الاسم فارغ أو أطول من 40 حرفًا أو فيه محارف تحكّم أو بشكل c_ مع 12 حرفًا أو كلمة من كلمات API: bulk وfind
400 taken- هذا الاسم مستخدم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"name":"de-2","protocols":"reality,shadowsocks:9388"}'GET/nodes/{name}عقدة واحدةقراءة
المعاملات
nameفي المسار- اسم العقدة
application/json{
"name": "de-1",
"host": "203.0.113.10",
"reported": "203.0.113.10",
"address": "",
"port": 443,
"up": true,
"seen": 1793753990,
"connected": 31,
"protocols": ["Veli", "Reality"],
"ports": [
{ "kind": "veli", "label": "Veli", "port": 443 },
{ "kind": "reality", "label": "Reality", "port": 8443 }
],
"version": "1.8.0",
"behind": false,
"disabled": false,
"main": false,
"added": 1791158400,
"devices": 58,
"traffic": 912680550400,
"at": 1793754000,
"sni": "www.samsung.com"
}الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes/de-1" \
-H "Authorization: Bearer $VELI_TOKEN"POST/nodes/{name}تغيير عقدةالكل
المعاملات
nameفي المسار- اسم العقدة
application/json{
"change": { "address": "de1.example.com", "disabled": false }
}application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
400 main- العقدة الرئيسية للوحة المصغّرة لا تُعطَّل ولا تُزال
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes/de-1" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"change":{"address":"de1.example.com","disabled":false}}'GET/nodes/{name}/statsحركة بيانات العقدة يومًا بيومقراءة
كما للعميل: التواريخ بتوقيت UTC، والبايتات في الاتجاهين.
المعاملات
nameفي المسار- اسم العقدة
daysفي الاستعلام- عن كم يومًا: 7 أو 30 أو 90؛ ودونه — 30
application/json{
"days": ["2026-10-29", "2026-10-30", "2026-10-31", "2026-11-01", "2026-11-02", "2026-11-03", "2026-11-04"],
"bytes": [0, 52428800, 104857600, 314572800, 209715200, 419430400, 188743680]
}الأخطاء
404 none- المطلوب غير موجود، أو استدعاء غير معروف
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes/de-1/stats?days=7" \
-H "Authorization: Bearer $VELI_TOKEN"POST/nodes/{name}/removeإزالة عقدةالكل
تخرج أسطرها من الاشتراكات. والعقدة الرئيسية للوحة المصغّرة لا تُزال — main.
المعاملات
nameفي المسار- اسم العقدة
application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 main- العقدة الرئيسية للوحة المصغّرة لا تُعطَّل ولا تُزال
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/nodes/de-2/remove" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTالمجموعات4
GET/groupsمجموعات العملاءقراءة
application/json{
"at": 1793754000,
"groups": [
{
"name": "europe",
"nodes": ["de-1", "nl-1"],
"protocols": null,
"clients": 42
}
],
"nodes": ["de-1", "nl-1", "fi-1"],
"kinds": [
{ "kind": "veli", "label": "Veli" },
{ "kind": "reality", "label": "Reality" }
]
}الأخطاء
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/groups" \
-H "Authorization: Bearer $VELI_TOKEN"POST/groupsإضافة مجموعةالكل
الحقلان nodes وprotocols — من قائمتي nodes وkinds في رد «GET groups»؛ وnull — الكل.
application/json{
"group": {
"name": "europe",
"nodes": ["de-1", "nl-1"],
"protocols": null
}
}application/json{ "done": 1 }الأخطاء
400 name- الاسم فارغ أو أطول من 40 حرفًا أو فيه محارف تحكّم أو بشكل c_ مع 12 حرفًا أو كلمة من كلمات API: bulk وfind
400 taken- هذا الاسم مستخدم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/groups" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"group":{"name":"europe","nodes":["de-1","nl-1"],"protocols":null}}'POST/groups/{name}تغيير مجموعةالكل
الجسم هو المجموعة كاملة، كما عند إضافتها.
المعاملات
nameفي المسار- اسم المجموعة
application/json{
"group": {
"name": "europe",
"nodes": null,
"protocols": ["veli"]
}
}application/json{ "done": 1 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
400 bad- قيمة خارج الحدود، أو مجموعة أو عقدة غير معروفة. field يسمّي الحقل، وmax الحد
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/groups/europe" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"group":{"name":"europe","nodes":null,"protocols":["veli"]}}'POST/groups/{name}/removeحذف مجموعةالكل
يبقى عملاؤها — بلا مجموعة، مع كل العُقد والبروتوكولات. وdone — كم كانوا فيها.
المعاملات
nameفي المسار- اسم المجموعة
application/json{ "done": 42 }الأخطاء
400 none- لا عميل ولا عقدة ولا مجموعة بهذا الاسم
401 token- لا رمز، أو أنه أُلغي أو انتهت مدته. هل ما زال موجودًا — يُظهره veli token list على خادم اللوحة
403 rights- ليس للرمز هذه الصلاحيات: مثلًا لا يحذف العملاء إلا «الكل». يُظهر GET me الصلاحيات
429 wait- أكثر من 300 طلب في الدقيقة على الرمز، أو عشرة رموز خاطئة من هذا العنوان خلال 15 دقيقة. انتظر عدد الثواني المذكور في Retry-After
500 db- تعذّر على اللوحة حفظ التغيير — كرّر، بالمفتاح نفسه
curl -s "$VELI/groups/europe/remove" \
-H "Authorization: Bearer $VELI_TOKEN" -X POSTمخطط OpenAPI وعميلك الخاص
تعطي اللوحة مخطط الواجهة كلها، OpenAPI 3.1. ويطابق اختبارُ اللوحة المخططَ مع الشيفرة: لا يوجد استدعاء خارج المخطط. منه يُبنى عميل بلغتك، وتأخذه Postman وInsomnia وn8n وأنظمة أخرى.
curl -s "$VELI/openapi.json" \
-H "Authorization: Bearer $VELI_TOKEN" -o veli-openapi.jsonnpx openapi-typescript veli-openapi.json -o veli-api.d.ts # types for TypeScript
npx @openapitools/openapi-generator-cli generate -i veli-openapi.json -g python -o veli_client # a Python clientلا تُنشأ الرموز وخطافات الويب عبر API: لا ينشئها إلا سطر الأوامر (veli token add وveli webhook add).
الحالات
on- يعمل: المدة سارية والبيانات متوفرة
soon- يعمل، لكن المدة تنتهي خلال 3 أيام — وقت التذكير
limit- نفدت بيانات الفترة: الرابط يُفتح، لكن الاتصال غير ممكن حتى إعادة التعيين أو حد جديد
off- انتهت المدة: الرابط يُفتح ويعرض «انتهى الاشتراك»، ولا يمكن الاتصال. مُدّد — يتصل من جديد
paused- عُطّل يدويًا أو بواسطة النظام؛ والمدة تجري في أثناء ذلك
waiting- المدة تنتظر أول اتصال: هدية أو «اشترى مسبقًا»
في القائمة وفي الأحداث
id- يبدأ بـ c_ ثم 12 حرفًا — وهو دائم: إعادة التسمية لا تغيّره. يعمل في المسار بدل الاسم: clients/c_Ab3dE5fG7hJ9. احفظه لديك، لا الاسم
name- الاسم، من 1 إلى 40 حرفًا، ولكل عميل اسمه؛ ولا يجوز شكل c_ مع 12 حرفًا — فهكذا يبدو id
external- المعرّف الخارجي — معرّفك للعميل؛ فارغ — لا يوجد. وهو ليس فريدًا: قد يشتري شخص واحد اشتراكين، لذا يعيد البحث قائمة
tags- الوسوم
status- القيمة on أو soon أو limit أو off أو paused أو waiting — أعلاه
until- نهاية المدة بتوقيت unix؛ 0 — بلا نهاية أو المدة ما زالت تنتظر أول اتصال
wait, first- كم ثانية من المدة تبدأ مع أول اتصال (0 — لا انتظار)؛ ومتى أخذ التطبيق الاشتراك أول مرة (0 — لم يحدث بعد)
left- المتبقي: days وbytes؛ وnull — بلا مدة وبلا حد
devices, held, veli- عدد الأجهزة المسموح بها، والمشغولة بكل التطبيقات، ومنها أجهزة Veli
speed- سرعة Veli في كل اتجاه بالميغابت/ث؛ 0 — بلا حد
limit, reset, used, next- حد البيانات بالبايت (0 — بلا حد)، وإعادة التعيين — never أو day أو week أو month بتوقيت UTC، والمستهلك خلال الفترة، وبداية الفترة التالية
group- المجموعة؛ فارغ — بلا مجموعة
bytes- البيانات طوال الوقت
seen, changed- آخر طلب للاشتراك من التطبيق (بدقة 10 دقائق، و0 — لم يحدث)؛ وآخر تغيير يدوي أو من النظام
note, contact, added- الملاحظة وجهة الاتصال ووقت الإضافة
عند العميل الواحد فقط — GET clients/<name>
at- وقت إعداد الرد، بتوقيت unix
link- رابط الاشتراك — وهو سرّ: يُعطى للعميل وحده
page- صفحة الاشتراك للمتصفح، مع أزرار التطبيقات
apps- روابط «إضافة إلى …» لكل تطبيق
list- الأجهزة: id، وkind — veli (مفتاح Veli) أو app (معرّف HWID لتطبيق آخر)، وos، وadded؛ ولجهاز Veli أيضًا bytes
lines- أسطر البروتوكولات العادية حسب العقدة: node وkind وline
meta- حقول نظامك
disabled- القيمة true — العميل موقوف
أزرار التطبيقات
الحقل apps — روابط «إضافة إلى …» جاهزة: Happ وv2rayNG وHiddify وStreisand وsing-box وClash وShadowrocket وv2RayTun وVeli. يضعها الموقع والرسالة في أزرار. لا تقبل الأزرار في المحادثات والرسائل إلا https://، لذا الأنسب page — صفحة الاشتراك، وفيها أزرار التطبيقات. وفي لوحة على IP بشهادتها الخاصة لن تتحقق التطبيقات الأخرى من الرابط — هناك Veli فقط.
المتبقي
الحقل left — ما تبقى: days — أيام المدة الكاملة (للمنتظر — مدة انتظاره)، وbytes — بايتات الفترة؛ وnull في حقل — بلا مدة أو بلا حد. إنه سطر جاهز لواجهتك: «بقي 12 يومًا و30 GB».
ما يمكن تغييره — حقول change
days- التمديد بهذا العدد من الأيام: من نهاية المدة، وللمنتهي — من الآن؛ وما دون الصفر — تقصير. وللمنتظر أول اتصال — انتظار أطول أو أقصر. أيام العميل الجديد بجانب change، وnull — بلا نهاية. ±1–36500
until- نهاية المدة بالضبط، بتوقيت unix؛ 0 — بلا نهاية. لا يُستخدم مع days. وإن كان في الماضي — تنتهي المدة الآن
start- القيمة first_use — تبدأ المدة مع أول طلب للاشتراك من التطبيق؛ وnow — يبدأ المنتظر مدته الآن
name- اسم جديد — لعميل واحد فقط؛ ويبقى id والرابط والأجهزة والبيانات
disabled- القيمة true — تعطيل: لا يُفتح الرابط، وتُزال الأجهزة من العُقد، والمدة تستمر؛ وfalse — تفعيل
relink- القيمة true — رابط جديد: يتوقف القديم، وتصبح حسابات البروتوكولات العادية جديدة، وتبقى أجهزة Veli
devices- عدد الأجهزة المسموح بها، من 1 إلى 100
speed- بالميغابت/ث، 0–100000؛ 0 — بلا حد
limit, reset, zero- حد البيانات بالبايت، وإعادة التعيين، وtrue — بدء العدّ من الصفر
group- المجموعة باسمها؛ فارغ — بلا مجموعة
external- المعرّف الخارجي، حتى 128 حرفًا؛ فارغ — حذفه
tags- الوسوم — القائمة كلها من جديد: حتى 20، وكل منها حتى 32 حرفًا
tags_add, tags_remove- إضافة وسوم وإزالتها، ويبقى الباقي — مناسب لتغيير كثيرين معًا
meta- حقول نظامك — كلها من جديد: حتى 20؛ المفتاح أحرف لاتينية وأرقام و _ . -، حتى 40 حرفًا؛ والقيمة حتى 500
note, contact- ملاحظة حتى 300 حرف، وجهة اتصال حتى 100
القيمة الأطول من اللازم لا تُقتطع، بل تعطي الخطأ bad مع الحقل والحد — {"error": "bad", "field": "change.devices", "max": 100}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.
المرشّحات والترتيب
دون معاملات يعطي GET clients الجميع. كل معامل يضيّق القائمة، ويمكن جمعها.
external, tag- المعرّف الخارجي، والوسم
status- مفصولة بفواصل: on,soon,limit,off,paused,waiting
group- المجموعة؛ والقيمة الفارغة — بلا مجموعة
q- كلمة في الاسم أو الملاحظة أو جهة الاتصال أو المعرّف الخارجي، دون تمييز حالة الأحرف
until_before, until_after- نهاية المدة قبل، بعد — بتوقيت unix؛ ولا يدخل من بلا نهاية هنا ولا هناك
changed_since- عُدّل يدويًا أو بواسطة النظام منذ هذا الوقت
devices- القيم none وsome وfull — لا أجهزة، توجد أجهزة، كل الأماكن مشغولة
used_over- استُهلك ما لا يقل عن هذه النسبة من الحد، %
seen_before- لم يأخذ التطبيق الاشتراك منذ هذا الوقت — أو لم يأخذه قط
sort- الترتيب حسب name أو until أو added أو used أو changed؛ و«-» في أوله — بالعكس
limit, cursor- الصفحة 1–1000 والمؤشر من next في الصفحة السابقة
curl -s "$VELI/clients?status=soon&sort=until&limit=100" \
-H "Authorization: Bearer $VELI_TOKEN"curl -s "$VELI/clients?q=anna&tag=paid&group=europe" \
-H "Authorization: Bearer $VELI_TOKEN"curl -s "$VELI/clients?devices=full&used_over=90" \
-H "Authorization: Bearer $VELI_TOKEN"curl -s "$VELI/clients?seen_before=1791158400&status=on" \
-H "Authorization: Bearer $VELI_TOKEN"الصفحات
- مع limit يكون الرد {at, clients, total, next}: total — كم عميلًا تحت المرشّح إجمالًا، وnext — مؤشر الصفحة التالية، وnull — هذه الأخيرة.
- المؤشر مكان في الترتيب لا رقم صفحة: العميل الذي يُضاف أو يُحذف بين الصفحات لا يزيح الآخرين — لا أحد يأتي مرتين ولا أحد يضيع.
- اطلب الصفحة التالية بالمرشّحات نفسها وsort نفسه، ولا يتغير إلا cursor.
{
"at": 1793754000,
"clients": [
{"id": "c_Ab3dE5fG7hJ9", "name": "order-88123", "status": "soon", "…": "…"}
],
"total": 412,
"next": "eyJrIjoxNzk0MDAwMDAwfQ"
}لمن هذا العميل
أرسل شخص إلى الدعم رابطًا أو مفتاح جهاز — جِد العميل. يمكن إرسال الرابط كاملًا أو سرّه فقط — الجزء بعد /s/.
curl -s "$VELI/clients/find" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"link": "kV0pX7wQ2mLr9sTb"}'
curl -s "$VELI/clients/find" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"device": "a1b2c3d4e5f6"}'كثيرون حسب مرشّح
الاستدعاء POST clients/bulk مع filter بدل names يغيّر كل من يشملهم المرشّح — الكل أو لا أحد. انظر أولًا من سيُمَسّ: dry: true يجيب بالعدد وأول 100 اسم دون تغيير شيء.
curl -s "$VELI/clients/bulk" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"filter": {"tag": "promo-nov", "status": ["on", "soon"]}, "change": {"tags_add": ["thanked"]}, "dry": true}'
curl -s "$VELI/clients/bulk" \
-H "Authorization: Bearer $VELI_TOKEN" \
-H "content-type: application/json" \
-d '{"names": ["order-88123", "c_Ab3dE5fG7hJ9"], "change": {"group": "europe"}}'{
"done": 0,
"matched": 412,
"names": ["order-88123", "order-88124", "…"]
}- المرشّح الفارغ يعطي bad: هكذا لا يُغيَّر «الجميع» صدفة. لكل الساريين — status: ["on", "soon"].
- الحقلان tags_add وtags_remove يغيّران الوسوم دون مسّ الباقي — مثلًا لتعليم من أُرسلت إليهم رسالة.
- لحذف كثيرين — remove: true بدل change، ويلزمه حق «الكل». يبقى المحذوفون في سلة المحذوفات 30 يومًا.