ודאו שהאינטגרציה שלכם עובדת כראוי לפני המעבר לסביבת הייצור.
הירשמו לתוכנית החינמית וקבלו את המפתח הציבורי שלכם מלוח הבקרה תחת
API Keys — הוא עובד מיד וניתן לשלוח אותו בבטחה בקוד צד־לקוח. השתמשו בו
לפיתוח מקומי ולבדיקות. העבירו אותו אל Tracio.init():
import { Tracio } from "@tracio/sdk"
const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" })const result = await tracio.getResult()console.log(result.visitorId, result.bot.detected)אם אתם טוענים את הסוכן דרך קטע ה־edge ללא build, אותו מפתח עובד בפרמטר השאילתה k:
<script src="https://edge.tracio.ai/s.js?k=YOUR_PUBLIC_KEY" async></script>הריצו זאת בקונסולת הדפדפן בעמוד שבו ה־SDK טעון כדי לאשר שהוא מאותחל ומחזיר תוצאה:
import { Tracio } from "@tracio/sdk"
const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" })const result = await tracio.getResult()console.assert(typeof result.visitorId === "string", "visitorId should be a string")console.assert(typeof result.bot.detected === "boolean", "bot.detected should be a boolean")console.log("Integration verified:", result.visitorId)בבדיקות יחידה בדרך כלל אינכם רוצים קריאת רשת אמיתית. בצעו mock למודול Tracio וּודאו שהקוד שלכם צורך את getResult() כראוי. עם Vitest:
import { vi, test, expect } from "vitest"import { Tracio } from "@tracio/sdk"
vi.mock("@tracio/sdk", () => ({ Tracio: { init: () => ({ getResult: async () => ({ visitorId: "test-visitor-id", bot: { detected: false, confidence: 0 }, }), }), },}))
test("renders the visitor id", async () => { const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" }) const result = await tracio.getResult() expect(result.visitorId).toBe("test-visitor-id") expect(result.bot.detected).toBe(false)})ניתן גם לבדוק את הטיפול בשגיאות על ידי גרימה לכך ש־getResult() הממוק ידחה עם TracioError.
כדי לפעול על תוצאת זיהוי בשרת שלכם, קבלו אותה כ־webhook חתום —
כל אירוע נשלח אל נקודת הקצה שלכם עם חתימת HMAC בשם X-Tracio-Signature שתוכלו
לאמת.