هذه الترجمة مولّدة آليًا وقيد المراجعة.التبديل إلى الإنجليزية
داكن
تسجيل الدخولاطلب جولة إرشادية

// تقييم المطورين

اعرف ما الذي يعمل وأين قبل التكامل.

يجمع المتصفح الأدلة المتاحة. يجري خادمك القراءة الموثّقة. ويتولى تطبيقك سياسة العميل وكل بديل احتياطي.

// حدود الثقة

تسليم من المتصفح إلى الخادم بملكية محددة بوضوح.

  1. عميل العميل

    يحمّل جامع البيانات العام ويمرر معرّف الجهاز المُعاد إلى الواجهة الخلفية للعميل.

    البديل الاحتياطي: يؤدي حظر JavaScript أو انخفاض قدرات المتصفح أو تعذّر الجمع إلى عدم توفر أدلة حديثة.

  2. معالجة Noxtica

    يعالج الأدلة التي تسمح بها قدرات المتصفح وسياسة المستأجر وحالة الموافقة.

    البديل الاحتياطي: النتيجة المفقودة أو غير المتاحة ليست نتيجة منخفضة المخاطر.

  3. خادم العميل

    يحافظ على سرية بيانات اعتماد API ويجري استعلام الجهاز الموثّق.

    البديل الاحتياطي: تظل الاستجابات المفقودة وغير الصالحة والمقيّدة بالمعدل وغير المتاحة حالات متميزة.

  4. سياسة العميل

    يجمع نتيجة الاستعلام مع سياق الحساب والعملية وإساءة الاستخدام المملوك للعميل.

    البديل الاحتياطي: لا تتخذ Noxtica القرار النهائي بالسماح أو التصعيد أو المراجعة أو الرفض.

  5. التحقيق والقياس

    يقارن المشغّلون الإجراءات المقترحة بالنتائج المؤكدة قبل الإنفاذ.

    البديل الاحتياطي: نجاح التثبيت وحده لا يثبت وجود سياسة جاهزة للإنتاج.

// المسار المُصان

أبسط مسار تكامل حالي.

تُعرض هذه الأمثلة من تجهيزات يتحقق منها اختبار مقتطفات المطورين. استبدل كل قيمة اصطناعية ببيانات الاعتماد والمُعرّفات الصادرة لتقييمك.

1. اجمع البيانات في المتصفح

المحمّل العام هو إصدار المتصفح الوحيد الذي تم التحقق منه حاليًا. يصدر معرّف جهاز أو حالة خطأ، ولا يتلقى أبدًا بيانات اعتماد للخادم.

<script src="https://collect.noxtica.com/collector/noxtica-collector-core.js" data-site-key="pk_example_replace_me" data-extensions="auto" data-auto-init data-auto-check-once async></script>
<script>
  document.addEventListener('noxtica:collected', (event) => {
    const deviceId = event.detail?.fingerprintId;
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: deviceId ? { state: 'received', deviceId } : { state: 'invalid' },
    }));
  });

  document.addEventListener('noxtica:error', () => {
    document.dispatchEvent(new CustomEvent('app:noxtica-evidence', {
      detail: { state: 'unavailable' },
    }));
  });
</script>

2. اقرأ النتيجة على خادمك

أرسل معرّف الجهاز إلى واجهتك الخلفية، ثم استدعِ مسار v1 الموثّق باستخدام مفتاح محفوظ على الخادم.

export async function lookupDevice({ deviceId, apiKey, fetchImpl = fetch }) {
  const response = await fetchImpl(
    `https://collect.noxtica.com/v1/device/${encodeURIComponent(deviceId)}`,
    { headers: { Authorization: `Bearer ${apiKey}` } },
  );

  if (response.status === 404) return { state: 'missing' };
  if (response.status === 429) return { state: 'rate_limited' };
  if (!response.ok) return { state: 'unavailable' };

  return { state: 'received', record: await response.json() };
}

3. أبقِ حالات النتائج منفصلة

لا تدخل في السياسة العددية إلا سجلات مكتملة تم استلامها. وتتبع حالات الفقدان وعدم الصلاحية والتقييد بالمعدل وعدم الإتاحة بدائل العميل الاحتياطية الصريحة.

export function classifyLookup(result) {
  if (!result || result.state === 'unavailable') return { state: 'unavailable' };
  if (result.state === 'rate_limited') return { state: 'rate_limited' };
  if (result.state === 'missing') return { state: 'missing' };

  const record = result.record;
  if (!record || typeof record.score !== 'number' || typeof record.confidence !== 'number') {
    return { state: 'invalid' };
  }

  return {
    state: 'received',
    score: record.score,
    riskLevel: record.riskLevel,
    confidence: record.confidence,
  };
}

// تم التحقق في 2026-09-20

مصفوفة الدعم العام الحالية.

لا تُدرج إلا الواجهات المدعومة بإصدار عام أو حد API يمكن الوصول إليه. ولا يُعد جرد الشيفرة الخاصة ادعاءً بالدعم.

الواجهةالتوفرالإصدار الحاليالمسؤولية والقيودالإرشادات
مُحمّل جامع بيانات المتصفحمتاح للعامة3.2.0تم التحقق 2026-09-20

يحمّل جامع بيانات المتصفح من أصل جامع Noxtica. يبلّغ شيفرة التطبيق بنتيجة الجمع أو بحالة عدم الإتاحة.

الأدلة المتاحة للمتصفح الحالي ولسياسة المستأجر وحالة الموافقة. يتطلب JavaScript. قد تقلل قدرات المتصفح أو السياسة من الأدلة المتاحة.

اعرض مثالًااقرأ الإرشادات
واجهة HTTP API للبحث الموثّق عن الأجهزةيتطلب الوصول للتقييمv1تم التحقق 2026-09-20

يتلقى معرّف الجهاز من خادم العميل فقط. يعيد السجل المقيّد بنطاق المستأجر عندما تسمح بيانات الاعتماد والنطاق بذلك.

السجل الموثّق المتاح للمستأجر الذي جرى توفيره. يتطلب الوصول للتقييم وبيانات اعتماد محفوظة على الخادم؛ ويُرفض الطلب غير الموثّق.

اعرض مثالًااقرأ الإرشادات

// نقاط تحقق التقييم

تحقق من التسليم قبل تغيير السياسة.

  1. وفّر الأصل المحدد بدقة ومفتاح الموقع العام للتقييم.
  2. راقب اكتمال الجمع وسلوك عدم الإتاحة معًا.
  3. مرّر معرّف الجهاز المُعاد فقط إلى الواجهة الخلفية للعميل.
  4. نفّذ القراءة الموثّقة باستخدام بيانات اعتماد محفوظة على الخادم.
  5. اختبر حالات الاستلام والفقدان وعدم الصلاحية والتقييد بالمعدل وعدم الإتاحة.
  6. قيّم السياسة المقترحة في وضع المراقبة قبل الإنفاذ.