API Проверка PerimeterX solver

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

API EverySolve для Проверка PerimeterX возвращает значения cookie для вашего сценария прохождения проверки. Отправьте POST /api/v1/captcha, указав в type значение perimeterx, и передайте входные данные, перечисленные ниже.PerimeterX, теперь часть HUMAN Security, — сценарий защиты приложения на уровне страницы, а не встроенный чекбокс. Возвращает cookie для прохождения защиты в рамках сессии, а не токен формы и не объявление о недвижимости с защищённого сайта.

$3.06 за 1 000 успешных решений ($0.003056 за каждое успешное решение). Неудачные решения не оплачиваются.

Промпт для ИИ

Помогите мне написать скрипт, который вызывает API EveryInfra «Проверка PerimeterX».

Контракт API:
- Запрос: POST https://api.everyinfra.com/api/v1/captcha с заголовком Authorization: Bearer <API Key>. Берите ключ из переменной окружения EVERYINFRA_API_KEY, не указывайте его в коде.
- В теле запроса задайте для type значение perimeterx, а параметры укажите рядом, на том же уровне.
- Обязательные параметры:
  - website_url: Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
  - proxy: Прокси для сессии решения; если результат привязан к сети, используйте ту же точку выхода для последующего запроса к целевому сайту.
- Необязательные параметры:
  - user_agent: User-Agent браузера для этой сессии проверки; не меняйте его, если возвращённый результат привязан к этой сессии.
  - website_key: Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
- Пример тела запроса:
{
  "type": "perimeterx",
  "website_url": "<website_url>",
  "proxy": "<proxy>"
}
- Оплата: $3.06 за 1 000 успешных решений ($0.003056 за каждое успешное решение). Неудачные решения не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.

Прежде чем писать код, спросите меня, сколько записей нужно обработать и в каком формате сохранить результаты, затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`type`	body	`string`	Да	`perimeterx`	Тип капчи, фиксированное значение.
`website_url`	body	`string`	Да	-	Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
`proxy`	body	`string`	Да	-	Прокси для сессии решения; если результат привязан к сети, используйте ту же точку выхода для последующего запроса к целевому сайту.
`user_agent`	body	`string`	Нет	-	User-Agent браузера для этой сессии проверки; не меняйте его, если возвращённый результат привязан к этой сессии.
`website_key`	body	`string`	Нет	-	Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.

Примеры кода

bash

curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": "perimeterx",
  "website_url": "<website_url>",
  "proxy": "<proxy>"
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json

{
  "id": "req_…",
  "type": "perimeterx",
  "solution": {
    "cookie": "…"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Откуда брать параметры для Проверка PerimeterX

Укажите website_url и тот же прокси, через который будет использован результат; user_agent и website_key применяются, только если целевой сайт их предоставляет.

Код для поиска этих значений на странице

perimeterx-1.js

({appId: window._pxAppId, vid: window._pxVid, uuid: window._pxUuid,
  host: window._pxHostUrl, jsClient: window._pxJsClientSrc,
  firstParty: window._pxFirstPartyEnabled, mobile: window._pxMobile})

perimeterx-2.txt

appId: "PXHYx10rg3"  hostUrl: "/HYx10rg3/xhr"
jsClient: "/HYx10rg3/init.js"  firstParty: true
uuid: "cce30591-a3d2-11f1-8eac-300ab9bc7c1b"

perimeterx-3.js

window._pxAppId ||
(document.documentElement.innerHTML.match(/PX[A-Za-z0-9]{8,10}/) || [])[0] ||
[...document.scripts].map(s=>s.src).find(s=>/perimeterx\.net|px-cdn\.net/.test(s))

Как определить Проверка PerimeterX

PerimeterX, теперь часть HUMAN Security, — сценарий защиты приложения на уровне страницы, а не встроенный чекбокс.

Чем Проверка PerimeterX отличается от других проверок

Возвращает cookie для прохождения защиты в рамках сессии, а не токен формы и не объявление о недвижимости с защищённого сайта.

Как использовать API для Проверка PerimeterX

API Проверка PerimeterX возвращает значения cookie в cookie. Формат решения: cookie. Добавляйте полученные поля cookie к последующим запросам в рамках того же сценария.

01Выполните запрос GET /api/v1/captcha/types и выберите запись perimeterx.
02Выполните POST /api/v1/captcha, передав type: "perimeterx" и обязательные параметры.
03Получите значения cookie из cookie.
04Добавляйте полученные поля cookie к последующим запросам в рамках того же сценария.

Оплата и доступность EverySolve списывает средства только при успешном предоставлении решения. За неудачную попытку итоговое списание не производится, а зарезервированная сумма возвращается автоматически. Получайте available и поля с ценами из GET /api/v1/captcha/types при отправке запроса, а не воспринимайте их как статические данные страницы.

Вопросы об интеграции Проверка PerimeterX

Как определить Проверка PerimeterX перед выбором типа?

PerimeterX, теперь часть HUMAN Security, — сценарий защиты приложения на уровне страницы, а не встроенный чекбокс. Используйте perimeterx, только если эти признаки соответствуют целевой проверке.

Какие значения с целевой страницы нужны в запросе для Проверка PerimeterX?

Укажите website_url и тот же прокси, через который будет использован результат; user_agent и website_key применяются, только если целевой сайт их предоставляет. Передайте website_url и proxy. Необязательные параметры: user_agent и website_key.

Что возвращает Проверка PerimeterX и с чем это не следует путать?

API Проверка PerimeterX возвращает значения cookie в cookie. Формат решения: cookie. Возвращает cookie для прохождения защиты в рамках сессии, а не токен формы и не объявление о недвижимости с защищённого сайта.

Какой внешний источник описывает интеграцию Проверка PerimeterX?

Официальная документация HUMAN Security описывает семейство продуктов PerimeterX для защиты приложений. [Открыть справку по Проверка PerimeterX](https://www.humansecurity.com/). Специфичные для EverySolve поля и текущую доступность по-прежнему смотрите в каталоге типов.

Справка по Проверка PerimeterX

Этот источник поясняет указанный тип капчи или термин веб-платформы. Он не означает, что получено разрешение или одобрение. В вопросах актуального формата запроса и ответа EverySolve, доступности и цен приоритет имеет публичный каталог типов.

Официальная документация HUMAN Security описывает семейство продуктов PerimeterX для защиты приложений. Этот источник подтверждает указанное рядом различие между продуктами, проверками или браузерными API. Актуальный формат запросов и ответов EverySolve определяет GET /api/v1/captcha/types.

Открыть справку по Проверка PerimeterX ↗

Все типы капчи

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки