Bắt đầu trong 5 phút
Năm bước để nhận diện thiết bị chính xác. Không cần thẻ tín dụng.
Đăng ký
Tạo tài khoản của bạn trong vài giây. Không cần thẻ tín dụng. Nhận 2,500 lượt gọi API miễn phí mỗi tháng.
Lấy public key
Sao chép public key của bạn từ bảng điều khiển. Đó là một chuỗi hex 40 ký tự, an toàn để đưa vào mã phía client.
Cài đặt SDK
Thêm thư viện client @tracio/sdk. Xem Quick Start để biết các gói dành riêng cho từng framework.
$ npm install @tracio/sdkĐang dùng một framework? Xem Quick Start để biết các gói React, Vue, Angular và Svelte.
Nhận diện khách truy cập
Khởi tạo bằng Tracio.init(), sau đó gọi tracio.getResult() để nhận ID khách truy cập duy nhất và kết quả phát hiện bot.
import { Tracio } from '@tracio/sdk'
// Initialize the SDK
const tracio = Tracio.init({ publicKey: '5ca175fc...' })
// Get the visitor identification
const result = await tracio.getResult()Xác minh
Xác nhận sự kiện đã đến phía máy chủ. TRACIO gửi mỗi lần nhận diện đến endpoint của bạn dưới dạng webhook đã ký, và mọi sự kiện cũng hiển thị trong bảng điều khiển của bạn.
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ác minh HMAC X-Tracio-Signature, sau đó xử lý payload. Xem Webhooks để biết payload đầy đủ và cách xác minh chữ ký.
Khắc phục sự cố
npm install thất bại?
Hãy đảm bảo bạn đang chạy Node.js v16 trở lên. Chạy node --version để kiểm tra.
Public key không hoạt động?
Xác minh rằng key của bạn là public key 40 ký tự từ workspace bạn đang làm việc.
Kết quả trống?
Kiểm tra cấu hình region của bạn có khớp với region bạn đã chọn khi đăng ký hay không.
Lỗi CORS?
Sử dụng thiết lập tích hợp proxy để định tuyến yêu cầu qua tên miền của riêng bạn.
Sẵn sàng bắt đầu?
Tạo tài khoản miễn phí và bắt đầu nhận diện khách truy cập trong chưa đầy 5 phút.