حماية البيانات مع CodeVeil

يوضّح هذا الدليل كيفية حماية البيانات الحساسة باستخدام CodeVeil: إخفاء المعلومات الشخصية (PII)، واستخدام التعمية المحافِظة على الصيغة حتى تظل بيانات الاختبار واقعية، وتشغيل مهام دفعية كبيرة تصل إلى 10,000 سجل، وتلقّي إشعارات عبر الـ Webhooks عند انتهائها.

إخفاء الحقول الحساسة

يُخفي CodeVeil المعلومات الشخصية (PII) والبيانات المالية والسجلات الصحية مع الحفاظ على الصيغة والتكامل المرجعي — فيُطابَق العميل نفسه مع القيمة المُخفاة ذاتها في كل مكان يظهر فيه. أرسِل السجلات إلى نقطة نهاية الإخفاء وحدِّد الحقول المراد حمايتها:

curl -X POST https://api.keepflow.ai/v1/codeveil/mask \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      { "name": "Jane Doe", "email": "[email protected]", "iban": "DE89370400440532013000" }
    ],
    "fields": {
      "name": "name",
      "email": "email",
      "iban": "iban"
    }
  }'

التعمية المحافِظة على الصيغة

مفتاح بيانات الاختبار المفيدة هو أن تبدو وتتصرّف مثل البيانات الحقيقية. يحافظ المُخرَج المُعمَّى من CodeVeil على البنية والأنواع والعلاقات نفسها التي في الأصل: يظل البريد الإلكتروني بريدًا صالح المظهر، ويحتفظ الـ IBAN برمز بلده وشكل مجموع التحقّق الخاص به، ويحتفظ رقم الهاتف بنمطه.

{
  "name": "Marta Lindqvist",
  "email": "[email protected]",
  "iban": "DE21500105174829471138"
}

ولأن الصيغة محفوظة، يمكنك إدراج مجموعة البيانات المُخفاة مباشرةً في بيئة تجهيز أو اختبار، فتظل كل عمليات التحقّق والربط وعلاقات المفاتيح الخارجية تعمل.

المعالجة الدفعية

للمجموعات الكبيرة، أرسِل ما يصل إلى 10,000 سجل في طلب واحد إلى نقطة نهاية المعالجة الدفعية. تعمل المهمة بشكل غير متزامن حتى لا تُبقي اتصالًا مفتوحًا:

curl -X POST https://api.keepflow.ai/v1/codeveil/batch \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-app.com/hooks/codeveil",
    "records": [ /* up to 10,000 records */ ],
    "fields": { "email": "email", "ssn": "national_id" }
  }'

تعيد الاستجابة معرّف مهمة (job ID) يمكنك استخدامه لاستعلام الحالة، أو يمكنك انتظار الـ Webhook.

{
  "data": { "job_id": "job_9f2a", "status": "processing", "record_count": 10000 }
}

Webhooks الإكمال

بدلًا من الاستعلام المتكرر، سجِّل callback_url وسيرسل CodeVeil طلب POST إليه عند انتهاء المهمة. تستخدم الحمولة الحدث data.processed:

{
  "event": "data.processed",
  "timestamp": "2026-07-17T09:12:00Z",
  "data": {
    "job_id": "job_9f2a",
    "status": "completed",
    "record_count": 10000,
    "download_url": "https://api.keepflow.ai/v1/codeveil/results/job_9f2a"
  }
}

تحقّق من ترويسة X-KeepFlow-Signature باستخدام سر الـ Webhook الخاص بك قبل الوثوق بالحمولة، ثم اجلب مجموعة البيانات المُخفاة من download_url. تظل النتائج متاحة لمدة 24 ساعة بعد الاكتمال.