Tạo fingerprint, chèn vào, hòa lẫn tự nhiên.
Yêu cầu một fingerprint trình duyệt nhất quán, sát thực tế qua một lệnh gọi REST đơn giản, rồi áp dụng các trường vào Playwright, Puppeteer hoặc Selenium để công cụ tự động hóa của bạn hiển thị như một máy hợp lý, nhất quán.
1. Bắt đầu
Lấy API key từ bảng điều khiển, sau đó yêu cầu một fingerprint. /generate tổng hợp một danh tính mới, duy nhất; /random trả về một danh tính thật từ pool.
# Generate a fresh, coherent fingerprint (quota deducts on success)
curl "https://api.capzy.ai/fingerprint/generate?key=YOUR_API_KEY&format=chromium&tags=Windows&country=us"- Lọc bằng tags (Windows, macOS, Linux, Android, iOS) và country (ISO alpha-2).
- format=chromium trả về các trường sẵn sàng để chèn; format=raw trả về toàn bộ dữ liệu.
- Chỉ trừ hạn mức khi tạo thành công.
2. Áp dụng vào công cụ tự động hóa
Đặt các trường cấp máy (userAgent, viewport, locale, timezone) trên trình duyệt, sau đó khớp navigator hiển thị với JS với cùng máy đó trước khi bất kỳ script nào của trang chạy.
import requests
from playwright.sync_api import sync_playwright
# 1. Generate a coherent fingerprint for a Windows visitor in the US
fp = requests.get("https://api.capzy.ai/fingerprint/generate", params={
"key": "YOUR_API_KEY",
"format": "chromium", # injection-ready
"tags": "Windows",
"country": "us",
}).json()
rect = fp["screen"]["screenRect"]
with sync_playwright() as p:
browser = p.chromium.launch()
# 2. Apply the machine-level fields on the context
context = browser.new_context(
user_agent=fp["userAgent"]["userAgent"],
locale=fp["intl"]["languages"][0],
timezone_id=fp["intl"]["timeZone"],
viewport={"width": rect["width"], "height": rect["height"]},
device_scale_factor=fp["screen"]["deviceScaleFactor"],
)
# 3. Match the JS-visible navigator to the SAME machine (before page scripts)
context.add_init_script(f"""
Object.defineProperty(navigator, 'hardwareConcurrency', {{ get: () => {fp['navigator']['hardwareConcurrency']} }});
Object.defineProperty(navigator, 'deviceMemory', {{ get: () => {fp['navigator']['deviceMemory']} }});
Object.defineProperty(navigator, 'platform', {{ get: () => '{fp['userAgent']['platform']}' }});
""")
page = context.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()Fingerprint Firefox và Safari hoạt động theo cùng cách. Các trường năng lực có trên Chromium (deviceMemory, hardwareConcurrency, client hints) bị lược bỏ ở những nơi trình duyệt thật không để lộ chúng.
3. Định dạng phản hồi
chromium sẵn sàng để chèn
Chính xác các trường bạn đặt trên trình duyệt: userAgent, screen, intl, navigator, webgl. Dùng cho các ví dụ ở trên.
raw toàn bộ dữ liệu
Toàn bộ payload fingerprint (canvas, fonts, visitor_id, webgl_properties) để lưu trữ hoặc dùng với trình chèn của riêng bạn.
4. Giữ tính nhất quán
Một fingerprint là một máy thật hợp lý, không phải tập hợp các trường ngẫu nhiên. Hai quy tắc giúp nó đáng tin:
Đặt userAgent, client hints và navigator từ cùng một phản hồi. Ghi đè UA trong khi client hints vẫn báo trình duyệt gốc là dấu hiệu lộ tự động hóa số một.
Dùng lại cùng fingerprint cho một profile/phiên nhất định. Xoay vòng các trường giữa phiên trông như một máy vừa thay phần cứng.
Kết hợp quốc gia bạn yêu cầu với IP egress tại quốc gia đó để múi giờ, ngôn ngữ và IP khớp nhau.
5. Câu hỏi thường gặp
random hay generate: dùng endpoint nào?›
/fingerprint/random trả về một thiết bị thật đã thu thập trước đó từ pool (rẻ). /fingerprint/generate tổng hợp một thiết bị mới, duy nhất theo các ràng buộc nhất quán nghiêm ngặt (chỉ trừ hạn mức khi thành công). Dùng generate khi bạn cần một danh tính độc nhất.
Định dạng chromium hay raw?›
chromium sẵn sàng để chèn: chính xác các trường bạn đặt trên trình duyệt (userAgent, screen, intl, navigator). raw trả về toàn bộ dữ liệu fingerprint (canvas, phông chữ, visitor_id, webgl_properties) để lưu trữ hoặc dùng với trình chèn của riêng bạn.
Tôi có cần đặt cả header Sec-CH-UA không?›
Fingerprint được tạo ra như một máy duy nhất, nên userAgent, header client-hint và navigator đều khớp nhau. Dấu hiệu lộ số 1 là ghi đè UA nhưng để client hint vẫn báo trình duyệt gốc, vì vậy hãy áp dụng các trường cùng nhau và đừng sửa riêng lẻ một trường.
Làm thế nào để nhắm đến một quốc gia hoặc hệ điều hành?›
Truyền country (ISO alpha-2, quyết định ngôn ngữ + múi giờ + giọng đọc) và tags (Windows, macOS, Linux, Android, iOS). Xem bảng tham số trên trang Fingerprint API.
Sẵn sàng bắt đầu?
Nhận API key và tạo fingerprint nhất quán đầu tiên của bạn.