Buat fingerprint, injeksikan, berbaur.
Minta fingerprint browser dunia nyata yang koheren melalui panggilan REST sederhana, lalu terapkan field-nya ke Playwright, Puppeteer, atau Selenium sehingga otomasi Anda melaporkan satu mesin yang masuk akal dan konsisten.
1. Memulai
Ambil API key dari dasbor Anda, lalu minta fingerprint. /generate membuat identitas baru yang unik; /random mengembalikan identitas sungguhan dari 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"- Filter dengan tags (Windows, macOS, Linux, Android, iOS) dan country (ISO alpha-2).
- format=chromium mengembalikan field siap diinjeksi; format=raw mengembalikan data lengkap.
- Kuota hanya dipotong jika pembuatan berhasil.
2. Terapkan dalam otomasi Anda
Atur field tingkat mesin (userAgent, viewport, locale, zona waktu) pada browser, lalu sesuaikan navigator yang terlihat oleh JS dengan mesin yang sama sebelum skrip halaman apa pun berjalan.
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 dan Safari bekerja dengan cara yang sama. Field kemampuan yang ada di Chromium (deviceMemory, hardwareConcurrency, client hint) dihilangkan jika browser sungguhan tidak menampilkannya.
3. Format respons
chromium siap diinjeksi
Field persis yang Anda atur pada browser: userAgent, screen, intl, navigator, webgl. Gunakan untuk contoh di atas.
raw data lengkap
Payload fingerprint lengkap (canvas, fonts, visitor_id, webgl_properties) untuk disimpan atau untuk injector Anda sendiri.
4. Jaga tetap koheren
Fingerprint adalah satu mesin nyata yang masuk akal, bukan kumpulan field acak. Dua aturan menjaganya tetap meyakinkan:
Atur userAgent, client hint, dan navigator dari respons yang sama. Menimpa UA sementara client hint melaporkan browser asli adalah tanda otomasi nomor satu.
Gunakan ulang fingerprint yang sama untuk profil/sesi tertentu. Merotasi field di tengah sesi terlihat seperti mesin yang berganti perangkat keras.
Pasangkan negara yang Anda minta dengan IP egress di negara tersebut sehingga zona waktu, bahasa, dan IP selaras.
5. FAQ
random vs generate: endpoint yang mana?›
/fingerprint/random mengembalikan perangkat sungguhan yang sebelumnya dikumpulkan dari pool (murah). /fingerprint/generate membuat perangkat baru yang unik di bawah batasan konsistensi yang ketat (kuota hanya dipotong jika berhasil). Gunakan generate saat Anda membutuhkan identitas yang benar-benar unik.
Format chromium vs raw?›
chromium siap diinjeksi: field persis yang Anda atur pada browser (userAgent, screen, intl, navigator). raw mengembalikan data fingerprint lengkap (canvas, fonts, visitor_id, webgl_properties) untuk disimpan atau untuk injector Anda sendiri.
Apakah saya juga perlu mengatur header Sec-CH-UA?›
Fingerprint diturunkan sebagai satu mesin, sehingga userAgent, header client-hint, dan navigator semuanya selaras. Tanda paling umum adalah menimpa UA tetapi membiarkan client hint melaporkan browser asli, jadi terapkan field-field tersebut bersamaan dan jangan mengedit salah satunya secara terpisah.
Bagaimana cara menargetkan negara atau OS?›
Kirim country (ISO alpha-2, mengatur bahasa + zona waktu + voice) dan tags (Windows, macOS, Linux, Android, iOS). Lihat tabel parameter di halaman Fingerprint API.
Siap memulai?
Dapatkan API key dan buat fingerprint koheren pertama Anda.