開発者体験

エンジニアによる、エンジニアのための設計

3行のコードで本番品質のデバイス識別を実現。設定ファイルも、ビルド手順も、ベンダーロックインもありません。

クイックスタート

ゼロから3行でデバイスフィンガープリントまで。あらゆる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とサーバー連携

ブラウザ向けの公式npm SDKに加え、署名付きWebhookにより、どのサーバーサイド言語でも識別イベントを受け取れます。すべてオープンソースで、すべて型付けされています。

クライアント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はありません。識別イベントは署名付きWebhook（HMAC-SHA256）としてバックエンドに配信されるため、あらゆるHTTPスタックで動作します。必要なときに履歴を読み出すには、シークレットキーでapi.tracio.ai/v1のServer APIを呼び出してください。Proプランから利用できます。

JSNode

PYPython

GOGo

RBRuby

PHPPHP

API機能

本番統合に必要なすべて。想定外はありません。

Webhook

サーバーへのリアルタイムなイベント通知。エンドポイントが受け取るイベントタイプを4種類から選択でき、配信に失敗した場合は数時間かけて自動的にリトライされます。

レート制限

明確なヘッダー付きの明確な制限。Server APIはProで毎秒10リクエスト、Businessで50、Enterpriseで200。すべてのレスポンスが残量を報告します。

署名検証

すべてのWebhookは、rawボディとタイムスタンプに対してHMAC-SHA256（X-Tracio-Signature）で署名されており、リプレイ攻撃に強く改ざん不可能な配信を実現します。

Server API

Bearerトークンとして送るシークレットキー（tracio_sk_…）を使い、HTTPS経由で訪問者履歴、セッション一覧、速度カウンターを照会できます。読み取り専用で、スコープはお客様のワークスペースに限定されます。

実際の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はオープンソースです。バグ報告、PRの提出、あるいはただコードを読むこともできます。透明性は機能のひとつです。

GitHubでスターを付ける完全なドキュメント