İçeriğe geç

Geliştirici Deneyimi

Mühendisler Tarafından, Mühendisler İçin

Üretim düzeyinde cihaz tanımlamaya üç satır kodla ulaşın. Yapılandırma dosyası yok, derleme adımı yok, tedarikçiye bağımlılık yok.

Hızlı Başlangıç

Sıfırdan cihaz parmak izine üç satırda. Herhangi bir JavaScript çerçevesiyle çalışır.

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()
Tam Hızlı Başlangıç KılavuzuAPI Playground

SDK'lar ve Sunucu Entegrasyonu

Tarayıcı için resmi npm SDK'ları, ayrıca imzalı webhook'lar sayesinde herhangi bir sunucu tarafı dili tanımlama olaylarını tüketebilir. Tümü açık kaynak, tümü türlenmiş.

İstemci SDK'ları

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

Sunucu tarafı

Kurulacak sunucu SDK'sı yok — tanımlama olayları arka ucunuza imzalı webhook'lar (HMAC-SHA256) olarak iletilir, böylece her HTTP yığını çalışır. Geçmişi istediğiniz anda okumak için, Pro planından itibaren kullanılabilen gizli anahtarınızla api.tracio.ai/v1 adresindeki Server API'yi çağırın.

JSNode
PYPython
GOGo
RBRuby
PHPPHP

API Özellikleri

Üretim entegrasyonu için ihtiyacınız olan her şey. Sürpriz yok.

Webhook'lar

Sunucunuza gerçek zamanlı olay bildirimleri. Bir uç noktanın dört olay türünden hangilerini alacağını seçin; başarısız iletimler birkaç saat boyunca otomatik olarak yeniden denenir.

Hız Sınırları

Net başlıklarla net sınırlar: Pro'da saniyede 10, Business'ta 50, Enterprise'da 200 Server API isteği. Her yanıt, ne kadarının kaldığını bildirir.

İmza Doğrulama

Her webhook, ham gövde ve bir zaman damgası üzerinden HMAC-SHA256 (X-Tracio-Signature) ile imzalanır ve size yeniden yürütmeye karşı güvenli, kurcalamaya dayanıklı teslimat sağlar.

Server API

Bearer token olarak gönderilen bir gizli anahtarla (tracio_sk_…) HTTPS üzerinden ziyaretçi geçmişini, oturum listelerini ve hız sayaçlarını sorgulayın. Salt okunur ve çalışma alanınızla sınırlı.

API İş Başında

Gerçek istek/yanıt örnekleri. Kopyalayın, yapıştırın, yayınlayın.

Webhook İmzalama Anahtarlarını Al

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

Ziyaretçi Ara

$ 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"
  }
}

Açık Kaynak, Açık Süreç

SDK'larımız açık kaynaktır. Hataları bildirin, PR gönderin ya da yalnızca kodu okuyun. Şeffaflık bir özelliktir.

GitHub'da bize yıldız verinTam Dokümantasyon