5 分钟即可上手运行
开始使用，仅需 5 分钟
五步实现精准设备识别。无需信用卡。
1
注册
几秒即可创建账户。无需信用卡。每月获赠 2,500 次免费 API 调用。
邮箱
you@company.com
密码
••••••••••••
创建账户
2
获取公钥
从仪表盘复制你的公钥。它是一个 40 位十六进制字符串，可安全地部署在客户端代码中。
你的公钥
5ca175fc530fcaacccf96a65190dea8a8c1f6fac
复制
3
安装 SDK
添加 @tracio/sdk 客户端库。针对特定框架的软件包请参阅快速入门。
4
识别访客
使用 Tracio.init() 初始化，然后调用 tracio.getResult() 即可获得唯一访客 ID 和机器人检测结果。
app.js
import { Tracio } from '@tracio/sdk'
// Initialize the SDK
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// Get the visitor identification
const result = await tracio.getResult()5
验证
确认事件已在服务端送达。TRACIO 会将每次识别以签名 webhook 的形式送达你的端点，同时每个事件也可在你的仪表盘中查看。
Webhook 投递（POST 到你的端点）
X-Tracio-Signature: t=1710432000,v1=5257a869…
{
"requestId": "1710432000_abc123def",
"visitorId": "X7fh2Hg9LkMn3pQr",
"bot": { "result": "human", "score": 0.02 },
"identification": { "confidence": 0.95 },
"geo": { "country": "CZ", "city": "Prague" }
}验证 X-Tracio-Signature HMAC，然后对负载进行处理。完整负载和签名验证方法请参阅 Webhooks。
故障排查
npm install 失败？
请确保你运行的是 Node.js v16 或更高版本。运行 node --version 进行检查。
公钥无效？
请确认你使用的密钥是当前所在工作区的 40 位公钥。
结果为空？
请检查你的区域配置是否与注册时所选区域一致。
CORS 错误？
使用代理集成方案，将请求通过你自己的域名进行路由。