Capzy Fingerprint API. Создайте согласованную идентичность.
Генерируйте отпечаток браузера в формате JSON. Выберите ОС и страну, используйте ту же идентичность при возвращении сессии и переносите результат в поддерживаемые настройки браузера.
customer-123en-US / America/New_YorkСгенерируйте профиль, затем примените его настройки
Начните с запроса отпечатка. Используйте поля ответа, которые поддерживает ваш фреймворк автоматизации; скачивание JSON не применяет все сигналы браузера автоматически.
# 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"])Активируйте API и скопируйте ключ
Выберите активный тариф Fingerprint API и используйте API-ключ Capzy из своего аккаунта. Храните его как CAPZY_API_KEY.
Открыть Fingerprint APIВыберите ограничения идентичности
Отправьте format=chromium, тег ОС и код страны. Используйте тот же id, uuid или seed с теми же параметрами, чтобы воссоздать идентичность.
Примените поддерживаемые поля в браузере
Пример на Playwright применяет user agent, локаль, часовой пояс и viewport. Для canvas, WebGL и других сигналов нужна поддержка на уровне конкретного браузера; см. полное руководство.
Выберите нужный профиль
Ключ обязателен. Параметры идентичности и фильтрации необязательны; при повторной генерации профиля сохраняйте их неизменными.
keyОбязательно · API-ключ- Ваш API-ключ Capzy. Храните его на сервере, а не в JavaScript браузера, публичных репозиториях или логируемых URL запросов.
id / uuid / seedНеобязательно · идентичность- Альтернативные селекторы идентичности. Передайте одно стабильное значение и используйте ту же конфигурацию фильтров для детерминированной генерации. Не указывайте их, чтобы получить новую идентичность.
formatПо умолчанию · chromium- Выберите chromium для JSON-структуры, ориентированной на браузер (используется в этих примерах), или raw для сырого представления профиля.
tagsНеобязательно · ОС- Фильтр семейства устройств, например Windows, macOS или Linux. Запрошенная ОС должна соответствовать используемому браузеру.
countryНеобязательно · двухбуквенный код- Задаёт локаль и региональные подсказки профиля. Страна отпечатка: это не прокси; настраивайте исходящий трафик браузера отдельно, если важно местоположение IP.
min_browser_version / browser_versionНеобязательно · ограничения версии- Фильтруйте версии с помощью полного справочника API. build_version и force_browser_version дают дополнительный контроль; используйте значения, которые поддерживает ваша интеграция с браузером.
Читайте отпечаток по группам
Сокращённый иллюстративный ответ. Реальный ответ API содержит полный отпечаток и может отличаться в зависимости от устройства и формата.
{
"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
}
}Выберите страну
Поддерживаемые страны (47)
Передайте country (ISO 3166-1 alpha-2). Язык, Accept-Language, часовой пояс, голоса синтеза речи и шрифты локали настраиваются соответственно.
Показаны все 47, прокрутите или воспользуйтесь поиском
Цены
Актуальные ежемесячные тарифы и лимиты запросов загружаются из публичного каталога. Проверьте активный лимит в панели управления.
Загрузка актуальных цен…
Что нужно знать
JSON меняет мой браузер автоматически?
Нет. Ваша интеграция должна применить каждую поддерживаемую настройку. Опции контекста Playwright охватывают часть полей, а для более глубоких сигналов нужен браузер или интеграция, умеющие их использовать.
Страна отпечатка совпадает со страной прокси?
Нет. Настройки отпечатка управляют сигналами устройства и локали. Прокси управляет исходящим сетевым трафиком. Согласуйте их, если вашему процессу нужна последовательная региональная идентичность.
Что делать, если достигнут лимит запросов?
Проверьте лимит запросов в минуту для активного тарифа и ограничения организации. Ставьте запросы в очередь или замедляйте их вместо повторных попыток с той же частотой.
Стройте согласованную сессию с самого начала.
Сгенерируйте один профиль, изучите его поля и примените их по руководству по интеграции.
