API Castle solver
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
API EverySolve для Castle возвращает набор токенов для вашего сценария прохождения проверки. Отправьте POST /api/v1/captcha, указав в type значение castle, и передайте входные данные, перечисленные ниже.Castle — сценарий оценки рисков и анализа устройств, в котором целевой сайт передаёт структурированные метаданные, а не видимую графическую головоломку. Возвращает набор токенов. Не сводите его к одному токену и не делайте вывод о визуальной капче по названию продукта.
$0.97 за 1 000 токенов ($0.000972 за токен). Каждый вызов оплачивается по числу токенов: цена × count. Вы платите только за возвращённые токены, а неудачные решения не оплачиваются.
Промпт для ИИ
Помогите мне написать скрипт, который вызывает API EveryInfra «Castle».
Контракт API:
- Запрос: POST https://api.everyinfra.com/api/v1/captcha с заголовком Authorization: Bearer <API Key>. Берите ключ из переменной окружения EVERYINFRA_API_KEY, не указывайте его в коде.
- В теле запроса задайте для type значение castle, а параметры укажите рядом, на том же уровне.
- Обязательные параметры:
- website_url: Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта.
- website_key: Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ.
- metadata: Структурированные публичные метаданные клиента, которые требует целевой сценарий Castle.
- Необязательные параметры:
- count: Запрашиваемое количество результатов для этой задачи в пределах ограничений, указанных в каталоге.
- user_agent: User-Agent браузера для этой сессии проверки; не меняйте его, если возвращённый результат привязан к этой сессии.
- proxy: Прокси для сессии решения; если результат привязан к сети, используйте ту же точку выхода для последующего запроса к целевому сайту.
- Пример тела запроса:
{
"type": "castle",
"website_url": "<website_url>",
"website_key": "<website_key>",
"metadata": "<metadata>"
}
- Оплата: $0.97 за 1 000 токенов ($0.000972 за токен). Каждый вызов оплачивается по числу токенов: цена × count. Вы платите только за возвращённые токены, а неудачные решения не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.
Прежде чем писать код, спросите меня, сколько записей нужно обработать и в каком формате сохранить результаты, затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
type | body | string | Да | castle | Тип капчи, фиксированное значение. |
website_url | body | string | Да | - | Точный адрес страницы, на которой появляется проверка, включая нужный путь, а не только главную страницу сайта. |
website_key | body | string | Да | - | Публичный ключ сайта или виджета, скопированный именно из этой интеграции на целевом сайте; это не секретный ключ. |
metadata | body | object | Да | - | Структурированные публичные метаданные клиента, которые требует целевой сценарий Castle. |
count | body | number | Нет | - | Запрашиваемое количество результатов для этой задачи в пределах ограничений, указанных в каталоге. |
user_agent | body | string | Нет | - | User-Agent браузера для этой сессии проверки; не меняйте его, если возвращённый результат привязан к этой сессии. |
proxy | body | string | Нет | - | Прокси для сессии решения; если результат привязан к сети, используйте ту же точку выхода для последующего запроса к целевому сайту. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"type": "castle",
"website_url": "<website_url>",
"website_key": "<website_key>",
"metadata": "<metadata>"
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.
{
"id": "req_…",
"type": "castle",
"solution": {
"tokens": "…"
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Откуда брать параметры для Castle
website_key и metadata должны быть из одной и той же интеграции целевого сайта; count, user_agent и proxy — необязательный контекст запроса.
Код для поиска этих значений на странице
[...document.scripts].map(s=>s.src).filter(s=>/castle\.io/.test(s))Как определить Castle
Castle — сценарий оценки рисков и анализа устройств, в котором целевой сайт передаёт структурированные метаданные, а не видимую графическую головоломку.
Чем Castle отличается от других проверок
Возвращает набор токенов. Не сводите его к одному токену и не делайте вывод о визуальной капче по названию продукта.
Как использовать API для Castle
API Castle возвращает набор токенов в tokens. Формат решения: tokens. Передайте полученные токены вместе, в том виде, в каком их ожидает запрос целевого сайта.
- 01Выполните запрос GET /api/v1/captcha/types и выберите запись
castle. - 02Выполните POST /api/v1/captcha, передав
type: "castle"и обязательные параметры. - 03Получите набор токенов из
tokens. - 04Передайте полученные токены вместе, в том виде, в каком их ожидает запрос целевого сайта.
Оплата и доступность Этот тип тарифицируется за токен: стоимость каждого вызова равна указанной цене × count, и вы платите только за возвращённые токены. EverySolve списывает средства только при успешном предоставлении решения. За неудачную попытку итоговое списание не производится, а зарезервированная сумма возвращается автоматически. Получайте available и поля с ценами из GET /api/v1/captcha/types при отправке запроса, а не воспринимайте их как статические данные страницы.
Вопросы об интеграции Castle
Как определить Castle перед выбором типа?
Castle — сценарий оценки рисков и анализа устройств, в котором целевой сайт передаёт структурированные метаданные, а не видимую графическую головоломку. Используйте castle, только если эти признаки соответствуют целевой проверке.
Какие значения с целевой страницы нужны в запросе для Castle?
website_key и metadata должны быть из одной и той же интеграции целевого сайта; count, user_agent и proxy — необязательный контекст запроса. Передайте website_url, website_key и metadata. Необязательные параметры: count, user_agent и proxy.
Что возвращает Castle и с чем это не следует путать?
API Castle возвращает набор токенов в tokens. Формат решения: tokens. Возвращает набор токенов. Не сводите его к одному токену и не делайте вывод о визуальной капче по названию продукта.
Какой внешний источник описывает интеграцию Castle?
На собственном сайте Castle описан продукт для оценки рисков и анализа устройств. [Открыть справку по Castle](https://castle.io/). Специфичные для EverySolve поля и текущую доступность по-прежнему смотрите в каталоге типов.
Справка по Castle
Похожие типы капчи
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.