迁移至 tracio.ai

注册并获取你的 API 密钥。免费方案包含 2,500 次免费 API 调用 —— 足以针对你当前的服务商运行一次完整的并行对比。

在现有指纹识别 SDK 旁边添加 @tracio/sdk。这是一次代码改动，而不是更换端点 —— tracio.ai 有自己的客户端，也有自己的结果结构。两者同时运行，就能在不影响生产流量的情况下直接在其上做对比。

npm install @tracio/sdk

识别结果会在访客被识别的那一刻，以签名 webhook 的形式推送到你的服务器，因此大多数集成可以彻底取消轮询循环。如果确实需要事后读取某次访问，自 Pro 方案起 Server API 支持按 requestId 查询。无论哪种方式，负载都是我们自己的扁平 camelCase 文档，字段只需映射一次。

// Before (competitor) — poll by requestId
const resp = await fetch("https://api.competitor.io/events/" + requestId, {
  headers: { "Auth-API-Key": COMPETITOR_API_KEY }
});

// After (tracio.ai) — receive a signed webhook per identification
app.post("/webhook/tracio", (req, res) => {
  // verify req.headers["x-tracio-signature"], then act on req.body
  const event = req.body; // { requestId, visitorId, bot, decision, ... }
  res.status(200).send("OK");
});

让两个 SDK 同时运行 24-48 小时。两家服务商的访客 ID 不会一致 —— 它们各自基于不同的数据库计算 —— 因此要对比真正重要的东西：同一台物理设备在多次访问中是否被稳定识别，以及机器人裁决在你的流量上是否吻合。

移除旧 SDK，并把 webhook 处理程序保留为服务端的唯一可信来源。整个过程没有停机 —— 在你去掉旧 SDK 之前，两个 SDK 一直并行运行。回访访客在我们的数据库中会从头开始，因此请用 linkedId 把他们映射到你已有的账户。如果出现任何问题，回滚路径只是重新安装旧 SDK。