كل المستندات

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

أدر قوائم السماح والحظر عبر الواجهة: أضف الأجهزة والمعرّفات التي ثبت احتيالها، واستثنِ الموثوقة، وأحِل الحالات غير المحسومة إلى المراجعة.

تنزيل 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.
  • راجع عناصر قائمة السماح دوريًا، لأنها قد تتخطى إشارات مخاطر مهمة.