ตรวจสอบว่าการเชื่อมต่อทำงานถูกต้องก่อนขึ้น production
สมัครใช้งานแพ็กเกจฟรีและรับ public key ของคุณจากแดชบอร์ดในส่วน
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 snippet แบบ zero-build คีย์เดียวกันนี้ใช้งานได้ในพารามิเตอร์ query k:
<script src="https://edge.tracio.ai/s.js?k=YOUR_PUBLIC_KEY" async></script>รันโค้ดนี้ใน console ของเบราว์เซอร์บนหน้าที่โหลด SDK ไว้ เพื่อยืนยันว่า 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)ใน unit test โดยทั่วไปคุณไม่ต้องการการเรียกเครือข่ายจริง ให้ 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() ที่ถูก mock ไว้ reject ด้วย TracioError
หากต้องการดำเนินการกับผลการระบุตัวตนบนเซิร์ฟเวอร์ของคุณเอง ให้รับผลนั้นในรูปแบบ
webhook ที่มีลายเซ็น — แต่ละเหตุการณ์จะถูกส่งไปยัง endpoint ของคุณพร้อมกับ
HMAC X-Tracio-Signature ที่คุณสามารถตรวจสอบความถูกต้องได้