Capzy Fingerprint API. Xây dựng một danh tính nhất quán.
Tạo fingerprint trình duyệt dưới dạng JSON. Chọn hệ điều hành và quốc gia, dùng lại danh tính khi một phiên quay lại, và ánh xạ đầu ra vào các thiết lập được trình duyệt hỗ trợ.
customer-123en-US / America/New_YorkTạo profile, sau đó áp dụng các thiết lập
Bắt đầu với một request fingerprint. Dùng các trường phản hồi mà framework tự động hóa của bạn hỗ trợ; tải JSON về không tự động áp dụng mọi tín hiệu trình duyệt.
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/fingerprint/generate",
params={
"key": os.environ["CAPZY_API_KEY"],
"format": "chromium",
"tags": "Windows",
"country": "us",
"id": "customer-123", # reuse with the same options
}, timeout=30,
)
response.raise_for_status()
fp = response.json()
if fp.get("errorId"):
raise RuntimeError(fp)
print(fp["userAgent"]["userAgent"])Kích hoạt API và sao chép key
Chọn một gói Fingerprint API đang hoạt động và dùng một API key Capzy từ tài khoản của bạn. Lưu thành CAPZY_API_KEY.
Mở Fingerprint APIChọn các ràng buộc danh tính
Gửi format=chromium, một tag hệ điều hành và một mã quốc gia. Dùng lại id, uuid hoặc seed với cùng tùy chọn để tạo lại một danh tính.
Áp dụng các trường được hỗ trợ vào trình duyệt
Ví dụ Playwright áp dụng user agent, locale, múi giờ và viewport. Canvas, WebGL và các tín hiệu khác cần hỗ trợ riêng cho từng trình duyệt; xem hướng dẫn đầy đủ.
Chọn profile bạn cần
Key là bắt buộc. Các tùy chọn danh tính và lọc là không bắt buộc; hãy giữ chúng nhất quán khi tạo lại profile.
keyBắt buộc · API key- API key Capzy của bạn. Giữ nó ở máy chủ, không để trong JavaScript của trình duyệt, repository công khai hoặc URL request được ghi log.
id / uuid / seedKhông bắt buộc · danh tính- Các bộ chọn danh tính thay thế. Cung cấp một giá trị cố định và dùng lại cùng cấu hình bộ lọc để tạo kết quả xác định. Bỏ qua để có danh tính mới.
formatMặc định · chromium- Chọn chromium cho cấu trúc JSON hướng trình duyệt được dùng trong các ví dụ này, hoặc raw cho dạng biểu diễn profile thô.
tagsKhông bắt buộc · hệ điều hành- Lọc họ thiết bị, ví dụ Windows, macOS hoặc Linux. Giữ hệ điều hành được yêu cầu nhất quán với trình duyệt bạn dùng.
countryKhông bắt buộc · mã hai chữ cái- Đặt locale và gợi ý profile theo khu vực. Quốc gia của fingerprint không phải là proxy; hãy cấu hình egress trình duyệt riêng khi vị trí IP quan trọng.
min_browser_version / browser_versionKhông bắt buộc · ràng buộc phiên bản- Lọc phiên bản theo tài liệu tham chiếu API đầy đủ. build_version và force_browser_version cung cấp thêm các tùy chọn kiểm soát; hãy dùng giá trị mà tích hợp trình duyệt của bạn hỗ trợ.
Đọc fingerprint theo nhóm
Phản hồi minh họa được rút gọn. Phản hồi API của bạn chứa fingerprint đầy đủ và có thể khác nhau tùy thiết bị và định dạng.
{
"id": "customer-123",
"country": "us",
"userAgent": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",
"platform": "Win32"
},
"screen": {
"innerWidth": 1903,
"innerHeight": 927,
"deviceScaleFactor": 1
},
"intl": {
"languages": [
"en-US",
"en"
],
"timeZone": "America/New_York"
},
"navigator": {
"hardwareConcurrency": 8,
"deviceMemory": 8
}
}Chọn quốc gia
Các quốc gia được hỗ trợ (47)
Truyềncountry (ISO 3166-1 alpha-2). Ngôn ngữ,Accept-Language múi giờ, giọng đọc và phông chữ theo locale đều được đặt cho khớp.
Đang hiển thị tất cả 47, cuộn hoặc tìm kiếm
Bảng giá
Các gói tháng và giới hạn request hiện tại được tải từ danh mục công khai. Hãy xác nhận hạn mức đang hoạt động của bạn trong bảng điều khiển.
Đang tải giá hiện tại…
Một vài điều cần biết
JSON có tự động thay đổi trình duyệt của tôi không?
Không. Tích hợp của bạn phải áp dụng từng thiết lập được hỗ trợ. Các tùy chọn context của Playwright bao gồm một số trường, còn các tín hiệu sâu hơn cần trình duyệt hoặc tích hợp được thiết kế để sử dụng chúng.
Quốc gia của fingerprint có giống quốc gia của proxy không?
Không. Thiết lập fingerprint kiểm soát tín hiệu thiết bị và locale. Proxy kiểm soát egress mạng. Hãy giữ chúng khớp nhau khi quy trình của bạn cần một danh tính khu vực nhất quán.
Nếu tôi chạm rate limit thì sao?
Kiểm tra hạn mức request mỗi phút của gói đang hoạt động và mọi giới hạn của tổ chức. Hãy đưa vào hàng đợi hoặc giảm tốc độ request thay vì liên tục thử lại với cùng tốc độ.
Xây dựng một phiên nhất quán ngay từ đầu.
Tạo một profile, kiểm tra các trường và áp dụng chúng theo hướng dẫn tích hợp.
