دليل المطوّر

# أرسل رد الوكيل للفحص — الترويسة x-api-key تحمل مفتاحك
curl -X POST https://www.reglint.ai/api/monitor/scan \
  -H "x-api-key: rgl_••••••••" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "agent_output": "رقم الهوية الوطنية للعميل هو 2468101213 محفوظ في النظام.",
    "industry": "finance",
    "mode": "full",
    "language": "ar"
  }'

{
  "final_decision": "REDACT",
  "safe_to_deliver": false,
  "violations_count": 2,
  "violations": [
    {
      "violation_id": "SA_NATIONAL_ID",
      "severity": "high",
      "law": "نظام حماية البيانات الشخصية السعودي، المادة 1 + اللوائح التنفيذية",
      "violating_text": "2468101213",
      "recommended_action": "REDACT",
      "floor_violation": false,
      "source": "rules_engine"
    }
  ],
  "redacted_output": "رقم الهوية الوطنية للعميل هو [REDACTED: SA_NATIONAL_ID] محفوظ في النظام.",
  "processing_time_ms": 12039,
  "metadata": { "rag_used": true, "mode": "full", "rag_country": null }
}

{
  "final_decision": "REDACT",
  "violations": [
    {
      "violation_id": "BH_CPR",
      "law": "قانون رقم 30 لسنة 2018 بشأن حماية البيانات الشخصية (البحرين)",
      "violating_text": "900712345",
      "recommended_action": "REDACT",
      "floor_violation": false,
      "source": "rules_engine"
    }
  ],
  "redacted_output": "الرقم الشخصي (CPR) للعميل في المنامة بالبحرين هو [REDACTED: BH_CPR].",
  "metadata": { "rag_used": true, "rag_country": "bh" }
}

{
  "rules_config": {
    "ar": { "default_action": "alert_hitl" },   // كل القواعد العربية → مراجعة بشرية
    "ar.bh": { "default_action": "block" },      // قواعد البحرين → حظر (تفوق مجموعة "ar")
    "BH_CPR": "REDACT"                           // قاعدة بعينها → تنقيح (تفوق الجميع)
  }
}

{
  "final_decision": "BLOCK",
  "violations": [
    {
      "violation_id": "KYC_BYPASS",
      "severity": "critical",
      "law": "قانون البنك المركزي رقم 194 لسنة 2020 — المادة 140؛ معايير مكافحة غسل الأموال",
      "recommended_action": "BLOCK"
    }
  ],
  "original_output": "[BLOCKED]",
  "metadata": { "rag_used": true, "mode": "full" }
}

import requests

# افحص رد الوكيل العربي قبل تسليمه للعميل
resp = requests.post(
    "https://www.reglint.ai/api/monitor/scan",
    headers={"x-api-key": "rgl_••••••••"},
    json={
        "agent_output": "رقم بطاقة العميل هو 4111 1111 1111 1111",
        "industry": "finance",
        "mode": "full",
        "language": "ar",           # يُفعّل المسار العربي
    },
    timeout=30,
)
result = resp.json()
# سلّم فقط عندما يكون القرار آمناً
if result["safe_to_deliver"]:
    deliver(result["redacted_output"])
else:
    hold_for_review(result)          # BLOCK / REDACT / ALERT_HITL

// افحص رد الوكيل العربي (Node 18+ ‏— fetch مدمج)
const res = await fetch("https://www.reglint.ai/api/monitor/scan", {
  method: "POST",
  headers: {
    "x-api-key": "rgl_••••••••",
    "Content-Type": "application/json; charset=utf-8",
  },
  body: JSON.stringify({
    agent_output: "الرقم القومي للعميل 29804151234567",
    industry: "finance",
    mode: "full",
    language: "ar",               // المسار العربي
  }),
});
const result = await res.json();
// القرار النهائي: PASS | ALERT | REDACT | BLOCK | ALERT_HITL
console.log(result.final_decision, result.violations);

# فحص عربي سريع من الطرفية
curl -X POST https://www.reglint.ai/api/monitor/scan \
  -H "x-api-key: rgl_••••••••" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"agent_output":"يمكنني فتح الحساب دون توثيق الهوية","industry":"finance","mode":"full","language":"ar"}'