Lokhu kuhumusha kwenziwe umshini futhi kusalindwe ukubuyekezwa.Shintshela esiNgisini
Kumnyama
NgenaCela ukuboniswa

// UKUHLOLA KONJINIYELA

Yazi ukuthi yini esebenza kuphi ngaphambi kokuhlanganisa.

Isiphequluli siqoqa ubufakazi obutholakalayo. Iseva yakho yenza ukufunda okuqinisekisiwe. Uhlelo lwakho lokusebenza lunomthwalo wenqubomgomo yekhasimende nazo zonke izipele.

// IMIKHAWULO YOKWETHEMBA

Ukudluliselwa kusuka kusiphequluli kuya kuseva ngobunikazi obucacile.

  1. Iklayenti lekhasimende

    Ilayisha umqoqi womphakathi bese idlulisela isihlonzi sedivayisi esibuyisiwe ku-backend yekhasimende.

    Isipele: I-JavaScript evinjiwe, amandla esiphequluli ancishisiwe, noma ukwehluleka kokuqoqa akulethi bufakazi obusha.

  2. Ukucubungula kwe-Noxtica

    Icubungula ubufakazi obuvunyelwa amandla esiphequluli, inqubomgomo yomqashi, nesimo semvume.

    Isipele: Umphumela ongekho noma ongatholakali awuwona umphumela wengozi ephansi.

  3. Iseva yekhasimende

    Igcina iyimfihlo imininingwane ye-API futhi yenza ukubhekwa kwedivayisi okuqinisekisiwe.

    Isipele: Izimpendulo ezingekho, ezingavumelekile, ezikhawulelwe ngesilinganiso, nezingatholakali zihlala zihlukene.

  4. Inqubomgomo yekhasimende

    Ihlanganisa ukubheka nolwazi olungelwekhasimende mayelana ne-akhawunti, umsebenzi, nokusetshenziswa kabi.

    Isipele: I-Noxtica ayenzi isinqumo sokugcina sokuvumela, sokudinga esinye isiqinisekiso, sokubuyekeza, noma sokwenqaba.

  5. Uphenyo nokukala

    Abasebenzisi bokusebenza baqhathanisa izenzo ezihlongozwayo nemiphumela eqinisekisiwe ngaphambi kokuyisebenzisa.

    Isipele: Ukufakwa ngempumelelo kukodwa akuqinisekisi inqubomgomo elungele ukukhiqiza.

// INDLELA ENAKEKELWAYO

Indlela yokuhlanganisa encane kunazo zonke yamanje.

Lezi zibonelo zinikezwa ama-fixture ahlolwa ukuhlolwa kwe-snippet yonjiniyela. Faka esikhundleni sawo wonke amanani okwenziwa imininingwane nezihlonzi ezikhishwe ukuze uhlolwe.

1. Qoqa kusiphequluli

Isilayishi somphakathi siwukuphela kokukhishwa kwesiphequluli okuqinisekisiwe okwamanje. Sikhipha isihlonzi sedivayisi noma isimo sephutha; asikutholi neze imininingwane yeseva.

<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. Funda kuseva yakho

Thumela isihlonzi sedivayisi ku-backend yakho, bese ubiza umzila oqinisekisiwe we-v1 ngokhiye ogcinwe kuseva.

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. Gcina izimo zemiphumela zihlukene

Irekhodi elamukelwe eliphelele kuphela elingena enqubomgomweni yezinombolo. Izimo ezingekho, ezingavumelekile, ezikhawulelwe ngesilinganiso, nezingatholakali zilandela izipele zamakhasimende ezicacisiwe.

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,
  };
}

// KUQINISEKISIWE 2026-09-20

Ithebula lamanje lokusekelwa komphakathi.

Kubalwa kuphela izindawo zokuxhumana ezisekelwa ukukhishwa komphakathi noma umngcele we-API ofinyelelekayo. Uhlu lwangaphakathi lwemithombo alusona isimangalo sokusekelwa.

Indawo yokuxhumanaUkutholakalaUkukhishwa kwamanjeIsibopho nemikhawuloIsiqondiso
Isilayishi somqoqi wesiphequluliKutholakala esidlangalaleni3.2.0Kuqinisekisiwe 2026-09-20

Ilayisha umqoqi wesiphequluli ku-origin yomqoqi ye-Noxtica. Ibika umphumela wokuqoqwa noma isimo sokungatholakali kukhodi yohlelo lokusebenza.

Ubufakazi obutholakala esipheqululini samanje, ngokwenqubomgomo yomqashi, nangesimo semvume. Idinga i-JavaScript. Amandla esiphequluli noma inqubomgomo kunganciphisa ubufakazi obutholakalayo.

Buka isiboneloFunda isiqondiso
I-HTTP API yokuqinisekisa ukubheka idivayisiKudingeka ukufinyelela kokuhlolav1Kuqinisekisiwe 2026-09-20

Yamukela isihlonzi sedivayisi kuphela kuseva yekhasimende. Ibuyisa irekhodi elilinganiselwe kumqashi lapho imininingwane nobubanzi kuvumela.

Irekhodi eliqinisekisiwe elitholakala kumqashi ohlinzekiwe. Idinga ukufinyelela kokuhlola nemininingwane egcinwe kuseva; isicelo esingaqinisekisiwe siyenqatshwa.

Buka isiboneloFunda isiqondiso

// AMAPHUZU OKUHLOLA

Qinisekisa ukudluliswa ngaphambi kokushintsha inqubomgomo.

  1. Hlinzeka nge-origin eqondile kanye ne-Site Key yomphakathi yokuhlola.
  2. Bheka kokubili ukuqedwa kokuqoqa nokuziphatha lapho kungatholakali.
  3. Dlulisela kuphela isihlonzi sedivayisi esibuyisiwe ku-backend yekhasimende.
  4. Yenza ukufunda okuqinisekisiwe usebenzisa imininingwane egcinwe kuseva.
  5. Hlola izimo ezamukelwe, ezingekho, ezingavumelekile, ezikhawulelwe ngesilinganiso, nezingatholakali.
  6. Hlola inqubomgomo ehlongozwayo kumodi yokubuka ngaphambi kokuyisebenzisa.