דלג לתוכן

חוויית מפתח

נבנה על ידי מהנדסים, עבור מהנדסים

שלוש שורות קוד לזיהוי מכשירים ברמת ייצור. ללא קובצי הגדרות, ללא שלבי בנייה, ללא נעילת ספק.

התחלה מהירה

מאפס לטביעת אצבע של מכשיר בשלוש שורות. עובד עם כל framework של JavaScript.

app.js
// 1. Install
npm install @tracio/sdk
// 2. Initialize
import { Tracio } from '@tracio/sdk'
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// 3. Identify
const { visitorId } = await tracio.getResult()
מדריך התחלה מהירה מלאAPI Playground

SDKs ושילוב בצד השרת

SDKs רשמיים ב-npm עבור הדפדפן, בתוספת webhooks חתומים כך שכל שפה בצד השרת יכולה לצרוך אירועי זיהוי. הכול קוד פתוח, הכול מטופס.

SDKs לקליינט

JSJavaScriptnpm install @tracio/sdk
REReactnpm install @tracio/react @tracio/sdk
VUVuenpm install @tracio/vue @tracio/sdk
NGAngularnpm install @tracio/angular @tracio/sdk
SVSveltenpm install @tracio/svelte @tracio/sdk

צד השרת

אין SDK שרת להתקנה — אירועי זיהוי נמסרים ל-backend שלכם כ-webhooks חתומים (HMAC-SHA256), כך שכל מחסנית HTTP עובדת. כדי לקרוא היסטוריה לפי דרישה, פנו ל-Server API בכתובת api.tracio.ai/v1 עם המפתח הסודי שלכם, זמין מתוכנית Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

תכונות API

כל מה שאתם צריכים לשילוב בסביבת ייצור. ללא הפתעות.

Webhooks

התראות אירועים בזמן אמת לשרת שלכם. בחרו אילו מארבעת סוגי האירועים יקבל כל endpoint; מסירות שנכשלו נשלחות שוב אוטומטית לאורך כמה שעות.

מגבלות קצב

מגבלות ברורות עם כותרות ברורות: 10 בקשות Server API לשנייה ב-Pro, 50 ב-Business ו-200 ב-Enterprise. כל תגובה מדווחת כמה נשאר לכם.

אימות חתימה

כל webhook חתום ב-HMAC-SHA256 (X-Tracio-Signature) על הגוף הגולמי וחותמת זמן, ומעניק לכם מסירה מוגנת מפני שידור חוזר ומפני שיבוש.

Server API

אתרו היסטוריית מבקרים, רשימות סשנים ומוני מהירות דרך HTTPS באמצעות מפתח סודי (tracio_sk_…) הנשלח כטוקן Bearer. לקריאה בלבד, ובהיקף ה-workspace שלכם.

ה-API בפעולה

דוגמאות בקשה/תגובה אמיתיות. העתיקו, הדביקו, שלחו.

משיכת מפתחות חתימה של Webhook

$ curl https://api.tracio.ai/.well-known/webhook-keys
{
  "keys": [
    {
      "kid": "k1",
      "alg": "Ed25519",
      "publicKey": "MCowBQYDK2VwAyEA9tR2v1kQ..."
    }
  ]
}

איתור מבקר

$ curl "https://api.tracio.ai/v1/visitors/X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y" \
  -H "Authorization: Bearer tracio_sk_XXXX...XXXX"
{
  "visitorId": "X7fh2Hg9LkMn3pQr5tBvQw3xZa9mK2pL4nR8dT6y",
  "firstSeenAt": "2026-02-01T08:11:00Z",
  "lastSeenAt": "2026-03-16T14:22:01Z",
  "visits": 14,
  "incognitoVisits": 2,
  "uniqueIps": 6,
  "uniqueCountries": 2,
  "risk": { "maxRiskScore": 63, "lastDecision": "real" },
  "network": {
    "vpnSeen": false,
    "proxySeen": false,
    "torSeen": false,
    "datacenterSeen": true
  },
  "meta": {
    "plan": "pro",
    "retentionDays": 30,
    "from": "2026-02-14T00:00:00Z",
    "to": "2026-03-16T14:30:00Z"
  }
}

קוד פתוח, תהליך פתוח

ה-SDKs שלנו הם קוד פתוח. דווחו על באגים, שלחו PRs, או פשוט קראו את הקוד. שקיפות היא תכונה.

סמנו אותנו בכוכב ב-GitHubתיעוד מלא