요청한 페이지로 가는 도중 대상이 봇 확인을 실행하면 FourA가 이를 알려줍니다. 이를 마주친 모든 request는 시스템 이름, 확인 통과 여부, 그리고 (통과 시) 다음 호출에서 이를 건너뛸 수 있도록 재사용 가능한 clearance가 포함된 필드와 함께 반환됩니다.

이 페이지는 해당 필드들에 대한 레퍼런스입니다. 전략에 대해서는 보호된 사이트를 참고하십시오.

필드 위치

Endpoint 필드 표시 조건
POST /api/single/ defense (object) response에서 봇 확인이 감지되었을 때
POST /api/proxy/ defense (object) 동일함, 응답한 시도에서 보고됨
POST /api/browser/ defenseSolved (boolean) 및 defenses (object) 로드된 페이지에서 항상 표시됨. 아무것도 감지되지 않은 경우 defenseSolved 값은 false이며 defenses 필드는 비어 있습니다.
POST /api/auto/ meta.solved (boolean) 래더가 시작된 후 모든 응답에 표시됨. 래더의 어느 단계에서든 확인이 통과되면 true입니다. 검증에 실패한 body나 확인되지 않는 호스트는 래더 시작 전에 meta 없이 응답됩니다.

필드가 없다는 것은 아무것도 감지되지 않았음을 의미합니다. defense 필드가 누락된 것을 실패로 해석하지 마십시오.

Single 및 Proxy에서 보고 기능을 사용하려면 기본적으로 활성화되어 있는 unblocker가 필요합니다. unblocker: false를 사용하면 페이지를 수신된 그대로 요청한 것이므로, Single은 challenge를 그대로 반환하고 Browser는 문제를 해결하지 않고 렌더링합니다.

Single 및 Proxy에서의 defense

{
  "status": 200,
  "data": "<!doctype html>...",
  "total_time": 3.61,
  "defense": {
    "vendor": "sgcaptcha",
    "solved": true,
    "present": ["sgcaptcha"],
    "ms": 3412,
    "hashes": 1048576,
    "complexity": 20,
    "cookie": "_I_=<clearance>"
  }
}
필드 타입 설명
vendor string 이 레코드가 다루는 시스템. 통과된 시스템이거나 감지된 주요 시스템입니다. 아래 공급업체 목록을 참조하십시오.
solved boolean true 값은 검증을 통과했으며 data(이)가 실제 페이지임을 의미합니다. false 값은 data(이)가 챌린지 페이지일 수 있음을 나타냅니다.
present string[] 이 response에서 인식된 모든 시스템. vendor보다 더 많은 이름을 포함할 수 있으며, 아직 아무도 통과하지 못한 시스템 이름도 포함될 수 있습니다.
ms number 검증 통과에 소요된 시간(밀리초). 통과된 경우에만 제공됩니다.
hashes number 챌린지에서 요구한 연산 작업량. 통과된 경우에만 제공됩니다.
complexity number 챌린지에서 명시한 난이도. 통과된 경우, 그리고 챌린지가 난이도를 보고하는 경우에만 제공됩니다.
answers number 단일 답변이 아닌 여러 답변을 요구하는 챌린지의 경우 제공된 승인 답변 수입니다. 통과된 경우에만 제공됩니다.
retry string 통과 대신 재시도를 통해 본문이 반환된 경우 존재합니다: refusal-cookies, amazon-continue, reddit-js-check 또는 verify-challenge. 아래를 참조하십시오.
cookie string 재생할 jar. 통과를 통해 획득한 clearance이거나 거부 응답이 전달한 session입니다.

solved: false(은)는 분기 처리가 필요한 케이스입니다. FourA는 챌린지 페이지를 절대 콘텐츠로 제공하지 않으므로, 이 플래그는 본문을 파싱하는 대신 에스컬레이션 처리가 필요함을 알리는 신호입니다.

retry: "refusal-cookies"

일부 사이트는 퍼즐을 실행하지 않습니다. 첫 번째 request를 거부하고 해당 거부 응답에 cookie를 설정한 뒤, 해당 cookie를 다시 전송하는 클라이언트에게 실제 페이지를 제공합니다. eBay의 상품 페이지가 대표적인 사례입니다.

이러한 상황이 발생하면 FourA가 대신 해당 cookie를 전송하고 실제 페이지를 제공합니다. 이 경우 response에는 retry: "refusal-cookies"(이)가 포함됩니다:

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "akamai",
    "solved": false,
    "present": ["akamai"],
    "retry": "refusal-cookies",
    "cookie": "bm_sv=...; dp1=..."
  }
}

다음과 같이 해석합니다:

  • solved 값은 false 상태를 유지합니다. 핸드셰이크에 응답하는 것은 챌린지를 통과(clear)하는 것이 아니며, 호출 비용에 영향을 주지 않습니다. 전송한 요청에 대해서만 비용이 청구됩니다.
  • data 값은 챌린지 페이지가 아닌 실제 콘텐츠입니다. 이는 solved: false 상태가 바디 에스컬레이션을 필요로 하지 않는 유일한 경우이며, 이 필드가 존재하는 이유이기도 합니다.
  • cookie 값은 사이트에서 발급한 세션입니다. 일반적인 clearance를 재사용하는 것과 동일한 방식으로 재생하면 이후 페이지에서 거부를 우회할 수 있습니다.
  • 재시도와 클리어는 단일 요청에서 동시에 발생할 수 있습니다. 재시도에 대한 응답이 FourA에서 해결 가능한 챌린지로 판명되면, 벤더 자체 필드가 포함된 solved: true와 함께 retry: "refusal-cookies"를 받게 됩니다.

재시도를 통해 콘텐츠가 반환되었으나 그 과정에서 감지된 시스템이 없는 경우 vendor 값은 unknown로 표시됩니다. 이 경우 present 값은 빈 배열이 됩니다.

retry: "amazon-continue"

Amazon은 응답으로 원버튼 로봇 확인 페이지를 반환할 때가 있습니다. 쇼핑을 계속하려면 클릭하라는 작은 페이지이며 정답은 이미 입력되어 있습니다. unblocker가 활성화되어 있으면(기본값), Single 및 Proxy는 동일한 출구 노드에서 사용자의 timeout_ms 내에 해당 버튼을 누른 후 생성된 쿠키를 사용하여 요청 페이지를 다시 호출합니다. 페이지가 열리면 응답에 retry: "amazon-continue"가 포함됩니다:

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "akamai",
    "solved": false,
    "present": ["akamai", "amazon"],
    "retry": "amazon-continue",
    "cookie": "ak_bmsc=...; ..."
  }
}

refusal-cookies 재시도처럼 처리하십시오. solved는 false 상태로 유지되고, data는 실제 페이지이며, 전송한 request에 대해서만 요금이 청구됩니다. cookie는 후속 페이지에서 재사용할 jar입니다. vendor 대신 present에서 amazon를 확인하십시오. 확인 페이지는 종종 FourA에서도 인식하는 cookie를 설정하며, vendor는 목록의 첫 번째 시스템 이름을 지정합니다.

사용자가 직접 정답을 확인해야 하는 동일한 검사의 이미지 버전은 보고된 후 수신된 그대로 유지됩니다. 확인 절차만 다시 호출하는 클릭 동작도 마찬가지입니다. 어느 쪽이든 해당 페이지에는 요금이 청구되지 않습니다(비용 안내 참조).

retry: "reddit-js-check"

Reddit은 때때로 가벼운 페이지 확인으로 응답합니다. 이는 숨겨진 form과 이를 작성하는 script가 포함된 작은 페이지입니다. unblocker가 켜져 있으면(기본값), Single 및 Proxy는 동일한 exit의 timeout_ms 내에서 해당 form을 제출하고 설정된 cookie와 함께 페이지를 다시 요청합니다. 이를 통해 페이지가 열리면 response에 retry: "reddit-js-check"가 포함됩니다.

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "reddit",
    "solved": false,
    "present": ["reddit"],
    "retry": "reddit-js-check",
    "cookie": "edgebucket=...; ..."
  }
}

이를 amazon-continue 재시도처럼 처리하십시오. solved 상태는 false(으)로 유지되고, data에는 실제 페이지가 포함되며, 요청한 건에 대해서만 요금이 청구되고, cookie은(는) 후속 페이지에서 재사용할 jar입니다. 확인 과정이 계속 반복되면 FourA는 페이지를 수신된 상태 그대로 유지하며 해당 페이지에는 요금이 청구되지 않습니다.

retry: "verify-challenge"

일부 사이트는 자체적인 짧은 확인 페이지로 시작됩니다. 스피너와 스크립트가 실행된 후 확인이 완료되면 실제 페이지로 이동하는 방식입니다. unblocker이(가) 활성화된 경우(기본값), Single 및 Proxy는 timeout_ms 내에서 동일한 exit을 통해 해당 확인을 완료하고 설정된 cookie를 포함하여 원래 페이지를 다시 요청합니다. 이를 통해 페이지가 열리면 응답에 retry: "verify-challenge"이(가) 포함됩니다.

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "verify-challenge",
    "solved": false,
    "present": ["verify-challenge"],
    "retry": "verify-challenge",
    "cookie": "token=..."
  }
}

reddit-js-check 재시도처럼 처리하십시오. solved는 false 상태를 유지하고, data는 실제 페이지이며, 전송된 request에 대해서만 요금이 청구됩니다. 또한 cookie는 후속 페이지에서 재사용할 저장소입니다. 확인 페이지가 응답 없이 반환되면 요금이 청구되지 않습니다.

브라우저에서의 defenses

{
  "status": 200,
  "body": "<!doctype html>...",
  "userAgent": "Mozilla/5.0...",
  "defenseSolved": true,
  "defenses": {
    "present": ["cloudflare"],
    "cleared": ["cloudflare"]
  }
}
필드 타입 설명
defenseSolved boolean 로드 중에 감지된 시스템이 있고 최종 페이지에 해당 통과(clearance) 상태가 유지될 때 true입니다. 호출 비용이 5크레딧인지 10크레딧인지를 결정하는 플래그입니다.
defenses.present string[] 최종 응답뿐 아니라 페이지 로드 중 어느 시점에서든 인식된 모든 시스템 목록입니다. 검사는 이미 발생한 이벤트이며, 실제 페이지가 도착할 때쯤에는 챌린지 응답이 사라진 상태입니다.
defenses.cleared string[] 최종 페이지가 통과 상태를 유지하고 있는 시스템 목록입니다.

present에는 있지만 cleared에는 도달하지 않는 이름은 FourA가 인식했으나 통과 상태를 획득하지 못한 시스템입니다. 아직 완료할 수 없는 시스템이거나, Browser가 다른 방식으로 처리하는 소수의 시스템 중 하나입니다(현재 통과 가능한 대상 참조). 이러한 시스템은 호출 비용을 증가시키지 않습니다.

벤더

vendor 값 시스템
cloudflare Cloudflare 챌린지 및 봇 관리
sgcaptcha SiteGround 사이트 검사
datadome DataDome
perimeterx PerimeterX
akamai Akamai Bot Manager
incapsula Imperva Incapsula
awswaf AWS WAF 챌린지
ebay-splashui eBay 자체 챌린지
reddit Reddit 자체 검사 및 거부 페이지
verify-challenge 검사가 완료되면 다음 페이지로 이동시키는 사이트 자체 검사 페이지
amazon Amazon 로봇 검사
hcaptcha hCaptcha
recaptcha reCAPTCHA
unknown 인식된 시스템이 없습니다. 벤더 정보 대신 재시도를 보고하기 위해 레코드가 생성되는 retry와 함께만 나타납니다.

현재 통과 가능한 대상

엔드포인트 통과 대상
Single, Proxy sgcaptcha, ebay-splashui. 둘 다 시각적 방식이 아닌 연산 기반이므로 브라우저가 개입하지 않습니다.
Browser cloudflare, sgcaptcha

일부 대상은 통과(clear) 없이 처리됩니다. Single 및 Proxy는 Amazon의 단일 버튼 로봇 검사를 클릭하고 이를 retry: "amazon-continue"로 보고하며, Reddit의 간단한 페이지 검사를 제출하고 이를 retry: "reddit-js-check"으로 보고하고, 사이트 자체 검사 페이지를 완료하고 이를 retry: "verify-challenge"로 보고합니다. Browser는 동일한 검사 페이지가 리디렉션될 때까지 최대 10초간 대기합니다. Browser는 Amazon 버튼을 클릭하며, Akamai 센서 페이지, AWS WAF 챌린지 페이지, DataDome 기기 검사 또는 eBay 자체 챌린지 페이지가 다음 페이지를 자체적으로 로드하는 동안 대기한 후 해당 페이지를 반환합니다. 해당 페이지가 도달하지 않으면 Browser는 대기 중이던 페이지를 timeout_ms 안에 담아 반환합니다. Browser에서 이러한 이름은 defenses.present에 표시되며, cleared에는 절대 표시되지 않고, 호출 비용은 5입니다.

목록의 다른 모든 항목은 인식 및 보고만 수행됩니다. FourA가 더 많은 항목을 통과 처리할 수 있게 됨에 따라 이 기준은 변경되므로, 이 표를 바탕으로 추측하지 말고 solved를 확인하십시오.

경계 상황에 대한 두 가지 참고 사항:

  • hcaptcha 및 recaptcha 역시 일반적인 폼 위젯입니다. 응답에서 실제로 차단(403, 429 또는 503)되었을 때만 보고되므로, 폼에 인증 위젯이 포함된 결제 페이지는 방어 조치로 보고되지 않습니다.
  • Cloudflare를 사용 중이라는 사실 자체는 방어 조치가 아닙니다. cloudflare 항목은 사이트가 Cloudflare를 사용해서가 아니라 실제 챌린지나 봇 관리 아티팩트가 응답에 존재할 때 표시됩니다.

Clearance 재사용

defense.cookie 필드의 핵심 목적입니다. clearance는 이를 획득한 exit IP 및 User-Agent에 바인딩되므로, 동일한 조합을 통해 재요청하면 검증을 다시 실행하지 않습니다.

import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# 1) First call pays for the clear.
first = requests.post(f"{API}/api/proxy/", headers=H, json={
    "maxTries": 5,
    "request": {"method": "GET", "url": "https://example.com/catalog"},
}).json()

defense = first.get("defense", {})
if defense.get("solved"):
    clearance = defense["cookie"]
    exit_id = first["proxy"]

    # 2) Follow-up pages skip the check: same exit, same clearance.
    for page in range(2, 6):
        r = requests.post(f"{API}/api/single/", headers=H, json={
            "method": "GET",
            "url": f"https://example.com/catalog?page={page}",
            "proxy": exit_id,
            "headers": [["Cookie", clearance]],
        }).json()
        print(page, r["status"])

첫 번째 호출에 통과 비용이 부과됩니다. 모든 재전송은 일반 가격이 적용되는 일반 request입니다.

재전송이 실패하는 세 가지 원인:

  1. 다른 출구. 통과 response가 반환한 proxy ID를 고정하세요. Reuse a Proxy Across Requests를 참조하세요.
  2. 다른 User-Agent. Browser response는 사용된 userAgent를 반환합니다. cookie와 함께 다시 전송하세요.
  3. 만료. 통과 권한은 대상 사이트가 설정한 자체 유효 기간을 가집니다. SiteGround는 전체 사이트에 대해 약 30일 동안 지속되며, Cloudflare 통과 권한은 보통 훨씬 짧습니다. 통과 권한을 캐시처럼 다루세요. 재전송 시 다시 챌린지가 반환되기 시작하면, 새로운 호출을 한 번 실행하여 새 권한을 가져오세요.

비용 안내

통과된 검사는 Browser의 가격에만 영향을 줍니다:

Engine Base Cleared defense
Single 1 (unblocker 사용 시 2) 변경 없음
Proxy 2 (unblocker 사용 시 4) 변경 없음
Browser 5 10

Browser는 솔버가 활성화되어 시스템이 실제로 통과되었을 때만 10을 청구합니다. 감지되었으나 통과되지 않은 시스템은 검사가 전혀 없는 페이지와 동일하게 5가 청구됩니다.

FourA가 인식한 검사 페이지 또는 거부 페이지가 HTTP 200으로 제공되는 경우(예: Amazon의 로봇 검사, Reddit의 인증 페이지, eBay의 챌린지 페이지) 어떤 endpoint에서도 요금이 청구되지 않습니다. Single, Proxy, Browser response는 이를 X-FourA-Check-Page에 명시합니다.

validate와 함께 사용

defense는 검사가 발생했음을 알려줍니다. validate는 FourA에 실제 페이지의 형태를 알려주므로, HTTP 200이 반환된 중간 페이지를 그대로 전달받는 대신 request를 정상적으로 실패 처리할 수 있게 합니다.

{
  "method": "GET",
  "url": "https://example.com/product/42",
  "validate": {
    "data": {"accept": ["Add to cart"], "fail": ["Just a moment"]}
  }
}

POST /api/auto/에서 validate은 래더가 챌린지 페이지를 수락하고 완료 처리하는 것을 방지합니다.

최근 업데이트: 2026년 11월 11일