تخطّي إلى المحتوى

تجربة المطوّر

مبني بواسطة مهندسين، من أجل المهندسين

ثلاثة أسطر من الكود للوصول إلى التعرّف على الأجهزة بمستوى الإنتاج. لا ملفات إعداد، ولا خطوات بناء، ولا ارتباط بمورّد واحد.

البدء السريع

من الصفر إلى بصمة الجهاز في ثلاثة أسطر. يعمل مع أي إطار عمل 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

حزم SDK وتكامل الخادم

حزم SDK رسمية على npm للمتصفح، بالإضافة إلى webhooks موقّعة حتى تتمكّن أي لغة على جانب الخادم من استهلاك أحداث تحديد الهوية. جميعها مفتوحة المصدر، وجميعها مع أنواع محدّدة.

حزم SDK للعميل

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 للخادم — تُسلَّم أحداث تحديد الهوية إلى الواجهة الخلفية لديك على هيئة webhooks موقّعة (HMAC-SHA256)، بحيث تعمل أي بنية HTTP. ولقراءة السجل عند الطلب، استدعِ الـ Server API على api.tracio.ai/v1 بمفتاحك السري، وهو متاح ابتداءً من خطة Pro.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

ميزات الـ API

كل ما تحتاجه للتكامل في بيئة الإنتاج. دون مفاجآت.

Webhooks

إشعارات أحداث في الوقت الفعلي إلى خادمك. اختر أيًّا من أنواع الأحداث الأربعة تتلقاه كل نقطة نهاية؛ وتُعاد محاولة التسليمات الفاشلة تلقائيًا على مدى عدة ساعات.

حدود المعدّل

حدود واضحة مع ترويسات واضحة: 10 طلبات Server API في الثانية على Pro، و50 على Business، و200 على Enterprise. وتُبلّغ كل استجابة بما تبقّى لك.

التحقّق من التوقيع

كل webhook موقّع بـ HMAC-SHA256 (X-Tracio-Signature) على الجسم الخام وطابع زمني، مما يمنحك تسليمًا آمنًا من إعادة التشغيل ومقاومًا للعبث.

Server API

ابحث في سجل الزائر وقوائم الجلسات وعدّادات النشاط عبر HTTPS بمفتاح سري (tracio_sk_…) يُرسَل كرمز Bearer. للقراءة فقط، ومحصور في نطاق مساحة عملك.

الـ 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"
  }
}

مفتوح المصدر، مفتوح العملية

حزم SDK لدينا مفتوحة المصدر. أبلغ عن الأخطاء، أو أرسل PRs، أو اقرأ الكود فحسب. الشفافية ميزة.

قيّمنا بنجمة على GitHubالوثائق الكاملة