개발자 경험

엔지니어가 엔지니어를 위해 만들다

프로덕션급 디바이스 식별까지 단 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와 함께, 서버 측 언어라면 무엇이든 식별 이벤트를 사용할 수 있도록 서명된 웹훅을 제공합니다. 모두 오픈소스이며, 모두 타입이 지정되어 있습니다.

클라이언트 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가 없습니다 — 식별 이벤트는 서명된 웹훅(HMAC-SHA256)으로 백엔드에 전달되므로 모든 HTTP 스택에서 작동합니다. 필요할 때 이력을 읽으려면 시크릿 키로 api.tracio.ai/v1의 Server API를 호출하세요. Pro 플랜부터 사용할 수 있습니다.

JSNode

PYPython

GOGo

RBRuby

PHPPHP

API 기능

프로덕션 통합에 필요한 모든 것. 예상치 못한 일은 없습니다.

Webhooks

귀하의 서버로 전달되는 실시간 이벤트 알림. 엔드포인트가 네 가지 이벤트 유형 중 무엇을 받을지 선택하세요. 전달에 실패하면 몇 시간에 걸쳐 자동으로 재시도합니다.

속도 제한

명확한 헤더가 포함된 명확한 제한. Server API 요청은 Pro 초당 10회, Business 50회, Enterprise 200회. 모든 응답이 남은 한도를 알려 줍니다.

서명 검증

모든 웹훅은 원본 본문과 타임스탬프에 대해 HMAC-SHA256(X-Tracio-Signature)으로 서명되어, 재전송에 안전하고 변조가 불가능한 전달을 보장합니다.

Server API

Bearer 토큰으로 보내는 시크릿 키(tracio_sk_…)를 사용해 HTTPS로 방문자 기록, 세션 목록, 벨로시티 카운터를 조회하세요. 읽기 전용이며 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"
  }
}

오픈 소스, 오픈 프로세스

당사의 SDK는 오픈소스입니다. 버그를 신고하고, PR을 제출하거나, 그냥 코드를 읽어보세요. 투명성은 하나의 기능입니다.

GitHub에서 Star 누르기 전체 문서