Trải nghiệm Nhà phát triển

Được xây dựng bởi kỹ sư, dành cho kỹ sư

Ba dòng mã để có nhận dạng thiết bị cấp sản xuất. Không tệp cấu hình, không bước build, không bị khóa vào nhà cung cấp.

Bắt đầu nhanh

Từ số không đến dấu vân tay thiết bị trong ba dòng. Hoạt động với bất kỳ framework JavaScript nào.

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()

Hướng dẫn Bắt đầu nhanh đầy đủ API Playground

SDK & Tích hợp Server

SDK npm chính thức cho trình duyệt, cùng webhook đã ký để bất kỳ ngôn ngữ phía server nào cũng có thể tiếp nhận các sự kiện nhận dạng. Tất cả đều mã nguồn mở, tất cả đều được định kiểu.

SDK Client

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

Phía server

Không cần cài SDK server — các sự kiện nhận dạng được gửi đến backend của bạn dưới dạng webhook đã ký (HMAC-SHA256), nên bất kỳ ngăn xếp HTTP nào cũng hoạt động. Để đọc lịch sử theo yêu cầu, gọi Server API tại api.tracio.ai/v1 bằng secret key của bạn, có từ gói Pro.

JSNode

PYPython

GOGo

RBRuby

PHPPHP

Tính năng API

Mọi thứ bạn cần cho tích hợp môi trường sản xuất. Không bất ngờ.

Webhooks

Thông báo sự kiện theo thời gian thực đến server của bạn. Chọn endpoint nhận loại nào trong bốn loại sự kiện; các lần gửi thất bại được thử lại tự động trong vài giờ.

Giới hạn tần suất

Giới hạn rõ ràng với các header rõ ràng: 10 yêu cầu Server API mỗi giây trên gói Pro, 50 trên Business, 200 trên Enterprise. Mọi phản hồi đều báo lại phần bạn còn lại.

Xác minh Chữ ký

Mỗi webhook được ký bằng HMAC-SHA256 (X-Tracio-Signature) trên phần thân thô và một dấu thời gian, mang lại khả năng chuyển giao an toàn trước tấn công phát lại và chống can thiệp.

Server API

Tra cứu lịch sử khách truy cập, danh sách phiên và bộ đếm tốc độ qua HTTPS bằng secret key (tracio_sk_…) gửi dưới dạng Bearer token. Chỉ đọc, và giới hạn trong workspace của bạn.

API trong Thực tế

Ví dụ request/response thật. Sao chép, dán, triển khai.

Lấy khóa ký Webhook

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

Tra cứu một Khách truy cập

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

Mã nguồn mở, Quy trình mở

Các SDK của chúng tôi là mã nguồn mở. Báo lỗi, gửi PR, hoặc chỉ đơn giản là đọc mã. Tính minh bạch là một tính năng.

Gắn sao cho chúng tôi trên GitHub Tài liệu đầy đủ