كل المستندات

واجهة القوائم

قوائم السماح والحظر وإدارة عضوية القوائم.

تنزيل Markdown
الأدلةمرجع APIأمثلة الكودأفضل الممارسات

واجهة القوائم

أدر إدخالات السماح والحظر العامة أو المخصصة للعملاء والأجهزة وعناوين IP.

الطريقةالمسارالاستخدام
GET/api/v1/listsعرض الإدخالات وتصفيتها
POST/api/v1/listsإضافة إدخال جديد
DELETE/api/v1/lists/:idحذف إدخال بالمعرف
POST/api/v1/lists/customer/:emailإضافة بريد عميل
DELETE/api/v1/lists/customer/:emailإزالة بريد عميل
POST/api/v1/lists/deviceإضافة بصمة جهاز
DELETE/api/v1/lists/device/:fingerprintإزالة بصمة جهاز
POST/api/v1/lists/ipإضافة عنوان IP
DELETE/api/v1/lists/ip/:ipإزالة عنوان IP
POST /api/v1/lists
curl -X POST https://api.naiza.ai/api/v1/lists \
  -H "x-api-key: naiza_api_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "listType": "block", "valueType": "ip", "value": "203.0.113.42" }'

إدارة دورة حياة الإدخال

  • استخدم listType=block للحظر وlistType=allow للاستثناء الموثوق.
  • احفظ سبب الإضافة والمالك وتاريخ المراجعة في metadata إن كانت متاحة.
  • استخدم المعرف الذي يعيده الإنشاء للحذف الدقيق، أو المسارات المخصصة للعميل والجهاز وIP.
  • راجع إدخالات السماح دوريًا لأنها قد تتجاوز إشارات مخاطر مهمة.