التوثيق/الاتصال/لوحتك الخاصة/الاستدعاءات·6 / 9

الاستدعاءات

الجسم والرد بصيغة JSON، عدا رمز QR فهو SVG أو PNG. ويُرمَّز الاسم في العنوان كما في encodeURIComponent، ويمكن وضع معرّف العميل id بدل الاسم. اضغط على استدعاء لترى معاملاته وجسمه ورده وأمرًا جاهزًا. ومن الأسهل حفظ العنوان والرمز في متغيّرات:

على خادمك
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…

الرمز والمخطط وMCP3

GET/meهذا الرمز: الاسم والصلاحيات والمدة وإصدار APIأي رمز
الرد 200application/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قراءة
الرد 200application/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" }
  }
}
الرد 200application/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 من الصفحة السابقة
الرد 200application/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" }
الرد 200application/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}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.

الرد 200application/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
الرد 200application/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}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.

الرد 200application/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» بدل رابط الاشتراك
الرد 200image/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.svg
GET/clients/{name}/statsحركة بيانات العميل يومًا بيومقراءة

التواريخ بتوقيت UTC، من الأقدم إلى اليوم؛ والبايتات في الاتجاهين.

المعاملات

nameفي المسار
اسم العميل أو معرّفه id
daysفي الاستعلام
عن كم يومًا: 7 أو 30 أو 90؛ ودونه — 30
الرد 200application/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
الرد 200application/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
الرد 200application/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" }
الرد 200application/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}: وإلا لما عرف نظامك أن ما حُفظ غير ما أرسله. ويعود العميل الجديد في الرد كاملًا مع الرابط.

الرد 200application/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
الرد 200application/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العملاء المحذوفونقراءة
الرد 200application/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 في سلة المحذوفات
الرد 200application/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 POST
POST/trash/{id}/removeحذف من السلة نهائيًاالكل

لا يمكن استعادته بعد ذلك.

المعاملات

idفي المسار
معرّف العميل id في سلة المحذوفات
الرد 200application/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 POST
POST/trash/clearإفراغ السلةالكل

كل المحذوفين — نهائيًا. done — كم كانوا.

الرد 200application/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
الرد 200application/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الملخّص: العملاء والأجهزة والعُقد والحركة والأحداثقراءة
الرد 200application/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
الرد 200application/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كل أجهزة كل العملاءقراءة
الرد 200application/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
الرد 200application/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
الرد 200application/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كل العُقدقراءة
الرد 200application/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" }
الرد 200application/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في المسار
اسم العقدة
الرد 200application/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 }
}
الرد 200application/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
الرد 200application/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في المسار
اسم العقدة
الرد 200application/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مجموعات العملاءقراءة
الرد 200application/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
  }
}
الرد 200application/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"]
  }
}
الرد 200application/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في المسار
اسم المجموعة
الرد 200application/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.json
أنواع لـ TypeScript أو عميل جاهز بلغة Python
npx 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"
البحث بكلمة بين المدفوعين من المجموعة europe
curl -s "$VELI/clients?q=anna&tag=paid&group=europe" \
  -H "Authorization: Bearer $VELI_TOKEN"
كل الأماكن مشغولة والبيانات عند 90 % — لمن يُقترح التمديد أو إضافة أجهزة
curl -s "$VELI/clients?devices=full&used_over=90" \
  -H "Authorization: Bearer $VELI_TOKEN"
الساريون الذين لم يتصلوا منذ 1 أكتوبر
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 يومًا.