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