مفاتيح المشروع

كل مشروع له مفتاح عام لإرسال الأحداث. مكانه كود الواجهة، وما يقدر يقرأ أي شيء.

أنواع المفاتيح

البادئةالاستخداموين ينفع يظهر
pk_live_إرسال الأحداث من موقعك أو تطبيقك الفعليكود الواجهة، عام
pk_test_التطوير: يقبل بعد localhost و 127.0.0.1 و Expo Goكود الواجهة، عام
rk_مفتاح قراءة: يفتح لوحة التحكم حق مساحة عملكأبد مو في كود الواجهة
datacub_mcp_ربط أداة ذكاء اصطناعي عن طريق MCPأبد مو في كود الواجهة

مفتاح pk_ يقدر بس يرسل أحداث، وبس من الأماكن اللي تسمح لها. عشان كذا آمن تنشره. والـ SDK يرفض أي مفتاح يبدأ بـ sk_ في أي بيئة: السر في المتصفح أو التطبيق يعتبر مكشوف.

تلقى المفتاح في الإعدادات، الربط تحت مفاتيح الإرسال.

المواقع والتطبيقات المسموح لها

datacub يقبل الأحداث بس من:

  • مواقع في قائمة المشروع: نطاق مثل shop.example.sa، أو *.example.sa لكل النطاقات الفرعية (ما تشمل النطاق الأساسي نفسه: أضفه بعد إذا فيه صفحات)
  • تطبيقات معرّفها (bundle ID أو package name) في قائمة المشروع، مثل sa.example.shop

القائمتين في الإعدادات، عام تحت من وين تجي البيانات. ومواقع الجهات الحكومية والتعليمية والصحية والعسكرية يراجعها datacub قبل ما ينحفظ أي حدث منها.

الطلب من أي مكان ثاني ينرفض بـ 403 origin_not_allowed أو 403 app_not_allowed، والـ SDK يوقف الإرسال لهذي الصفحة أو هذي الفتحة للتطبيق. هذي الفحوصات تمنع مفتاحك ينستخدم بالغلط في موقع غيرك. وهي مو سر: أي أحد يقدر يرسل طلبات يدّعي إنها من موقعك، فتعامل مع الأحداث الواصلة كبيانات، مو كإثبات.

التجربة والإنتاج

استخدم مفتاح pk_test_ وقت التطوير، والأفضل في مشروع منفصل، عشان زيارات التجربة ما تختلط بالمستخدمين الحقيقيين. datacub يقبل الأحداث من localhost و 127.0.0.1 و Expo Go بس مع مفتاح التجربة؛ ومفتاح الإنتاج ينرفض هناك. وكل مشروع جديد يجي ومعه مفتاح تجربة، مكتوب جنبه اختبار في الإعدادات، الربط؛ و مفتاح اختبار جديد يسوي غيره.

حط مفتاح التجربة في نسخ التطوير، ومفتاح الإنتاج في النسخة الفعلية. في Vite اكتب datacub.init('%VITE_DATACUB_KEY%') في الكود اللي في index.html، وحط VITE_DATACUB_KEY في .env.development و .env.production.

تغيير المفاتيح

المشروع يقدر يكون له مفتاحين بنفس الوقت، عشان تبدّل بدون انقطاع: في الإعدادات، الربط سوّ مفتاح جديد، وانشره، وبعدها ألغِ القديم. المفتاح الملغي يوقف خلال 15 ثانية.

مفتاح pk_ عام من الأساس، فنسخه مو اختراق. بدّل المفاتيح إذا أحد صار يرسل فيه بيانات خربانة.