FourA API에서 발생하는 에러를 처리하는 방법입니다.

에러 응답 형식

API는 모든 에러에 대해 플랫 JSON 객체를 반환합니다. 중첩된 error 객체는 없습니다. 머신 판독 가능한 코드가 있는 실패의 경우 최상위 필드로 제공됩니다. 요금제 한도 초과 시 reason, 적격한 출구가 없는 proxy 호출 시 code 필드가 포함됩니다.

{
  "error": "Invalid API key"
}

일부 오류에는 최상위 수준에 status, service, retryAfter, current 또는 limits와 같은 추가 필드가 포함됩니다.

{
  "error": "Rate limit exceeded",
  "status": 429,
  "service": "single",
  "retryAfter": 5,
  "current": { "concurrency": 12, "rpm": 3000 },
  "limits": { "maxConcurrency": 500, "maxRpm": 3000 }
}

Request 추적

모든 API response(성공 또는 에러)에는 해당 호출의 UUID가 포함된 X-FourA-Request-Id header가 포함됩니다. 단, FourA가 전혀 읽을 수 없는 body(잘못된 형식의 JSON 또는 100KB 초과 body)는 예외이며, 이는 ID가 할당되기 전에 거부됩니다. 이 ID를 클라이언트 측에 기록하십시오. 특정 request에 어떤 문제가 발생했는지 지원팀에 문의해야 하는 경우, 해당 ID를 통해 추적할 수 있습니다.

curl -i -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
# HTTP/1.1 200 OK
# X-FourA-Request-Id: 9f1c4e6c-7b2a-4d3e-8a1f-2c9d8e4a3b15
# Content-Type: application/json
# ...

오류 유형

400: 잘못된 요청

request 본문에 필수 필드가 누락되었거나, 유효하지 않은 값이 포함되어 있거나, API에서 조회를 거부하는 대상을 지정했습니다.

JSON 객체 또는 배열이 아닌 본문은 형식이 잘못된 JSON이며 아래와 같이 Invalid JSON in request body를 반환합니다.

Single, Proxy Finder 및 Browser에서 필드가 누락되었거나 유형이 잘못되었거나 범위를 벗어난 경우 메시지에 <field>: <reason>(으)로 표시됩니다. 중첩된 필드는 점(validate.status.accept)으로 연결됩니다. 최대 5개의 문제가 ; (으)로 구분되어 나열되며, 이를 초과하는 항목은 메시지 끝에 다음과 같이 표시됩니다. and <n> more:

{
  "error": "Invalid request: url: Invalid input: expected string, received undefined"
}

client_error이며 요금이 청구되지 않습니다. 대신 Auto는 아래의 /api/auto/에서 실패 읽기에 설명된 대로 수락할 수 없는 필드를 HTTP 200 내에서 보고합니다.

동일한 400 코드는 SSRF 보호에도 적용됩니다. url이 사설, 루프백 또는 기타 예약된 IP 범위(RFC 5735, RFC 6598, IPv6 예약 블록)로 확인되면 FourA 네트워크를 벗어나기 전에 request가 거부됩니다.

{
  "error": "Refusing to fetch <target>: target resolves to a private or reserved IP range. The FourA scraping API only forwards requests to public internet hosts."
}

<target>은 주소이거나, 호스트 이름 및 해당 이름이 확인(resolve)된 주소입니다. 파싱되지 않거나 http:// 또는 https://이 아닌 URL도 동일한 400을 반환합니다.

FourA 자체 API 호스트(eu.api.foura.ai 또는 api.foura.ai)를 대상으로 지정하면 리소스를 가져오거나 요금을 청구하기 전에 Single, Proxy Finder, Browser, Auto에서 모두 400 오류가 발생합니다. 이는 일반적으로 페이지에서 가져온 링크가 해당 페이지 자체가 아닌 API URL을 기준으로 확인되었음을 의미합니다.

{
  "error": "Refusing to fetch <url>: that is the FourA API itself, not a page. A link taken from a page was probably resolved against the API URL; resolve it against the page's own URL."
}

<url>은 사용자가 전송한 그대로의 대상입니다. Inspect 페이지는 유일한 예외로, FourA가 사용자를 대신해 여전히 https://eu.api.foura.ai/inspect를 가져옵니다.

내부에 공백이나 제어 문자가 포함된 URL 역시 Single, Proxy Finder 및 Auto에서 데이터를 가져오거나 과금하기 전에 400 오류를 수신합니다. 페이지에서 그대로 복사한 링크에는 이러한 문자가 자주 포함되어 있습니다(javascript: void(0), 텍스트에 공백이 포함된 공유 링크). 공백을 %20으로 인코딩하십시오. Browser는 Chrome과 동일한 방식으로 이러한 URL을 가져옵니다.

{
  "error": "invalid URL: it contains a space; encode it as %20 (the URL as sent: \"https://example.com/a b\")"
}

조회할 수 없는 호스트 이름은 거부되지 않습니다. 호출은 status: 0 및 사유(could not resolve <host>: <reason>)와 함께 HTTP 200으로 반환되며 요금이 청구되지 않습니다. FourA가 연결을 시도했으나 HTTP 응답을 받지 못한 대상(리디렉션 제한, 연결 또는 읽기 타임아웃, 리셋)도 error 및 total_time과 함께 status 없이 HTTP 200으로 반환됩니다. 요청 결과를 참고하십시오.

Single에서는 디코딩 후 128MB를 초과하는 응답 본문 처리가 즉시 중단됩니다. 호출은 "error": "Response body exceeds the 128 MB limit"과 함께 HTTP 200으로 반환되며 요금이 청구되지 않습니다.

본문의 잘못된 형식의 JSON은 필드를 읽기 전에 동일한 방식으로 거부됩니다.

{
  "error": "Invalid JSON in request body"
}

proxy 및 ignoreProxies 필드에는 고유한 400 오류가 있습니다. 두 필드 모두 이전 응답에서 반환된 불투명한 proxy ID를 사용하므로, 그 외의 값을 전달하면 디코딩에 실패합니다.

메시지 발생 원인
Invalid proxy format proxy 값이 FourA에서 발급한 proxy ID가 아닙니다. 원시 proxy 주소를 전달하면 이 오류가 발생합니다.
Invalid ignoreProxies format ignoreProxies의 항목 중 하나가 proxy ID가 아닙니다.
Proxy not found ID 디코딩은 완료되었으나 더 이상 활성 exit로 확인되지 않습니다. 새 ID를 선택하십시오.
Managed exit: this proxy id cannot be pinned to a request exit는 유효하지만 FourA가 지정된 요청을 위해 유지할 수 있는 대상이 아닙니다. 요금제에 남은 프리미엄 트래픽이 없을 때 프리미엄 exit ID를 전달하면 이 오류가 발생합니다. 해당 ID가 반환된 세션을 재사용하거나, POST /api/proxy/(으)로 호출을 실행하여 자동 선택된 exit를 사용하십시오.

해결 방법: 요청에 모든 필수 필드가 포함되어 있는지, URL이 http:// 또는 https://을(를) 사용하고 공백이 %20(으)로 인코딩되었는지, 호스트가 공용 주소로 확인되는지, 그리고 모든 proxy 값이 이전 응답에서 그대로 복사한 ID인지 확인하십시오.

이들은 client_error 결과입니다. 요청이 FourA 외부로 전송되지 않았으므로 비용이 소모되지 않았습니다.

401: 권한 없음

API 키가 누락되었거나 유효하지 않습니다.

누락된 키:

{
  "error": "Missing API key. Include X-API-Key header."
}

유효하지 않은 키:

{
  "error": "Invalid API key"
}

해결 방법: X-API-Key 헤더에 유효한 키가 포함되어 있는지 확인하십시오. 필요한 경우 대시보드에서 새 키를 생성하십시오.

401은 항상 FourA가 키를 확인한 후 거부했음을 의미합니다. FourA가 일시적으로 키를 확인할 수 없는 경우, 401 대신 503 API key check temporarily unavailable을 반환합니다(아래 참조).

403: 플랜에 포함되지 않음

현재 플랜에 포함되지 않은 엔드포인트 또는 매개변수를 요청했습니다. 응답은 X-FourA-Limit을 설정하고 본문의 reason에 동일한 코드를 반환합니다:

{
  "error": "The browser endpoint is not included in your plan (Free). Upgrade to use it.",
  "reason": "plan_limit_feature",
  "documentation": "https://foura.ai/prices"
}

reason 값은 플랜에서 제외된 endpoint이거나 지오 타겟팅이 없는 플랜에서 exitCountries 및 출구 위치 필드를 사용할 경우 plan_limit_feature이며, 프리미엄 출구가 없는 플랜에서 exitClass: premium을 사용하거나 프리미엄 트래픽이 남지 않은 출구 위치인 경우 plan_limit_premium입니다. error 문자열은 endpoint 또는 파라미터 이름을 지정합니다.

FourA에서 반환된 403은 대상 사이트와 무관합니다. 대상에 접속조차 하지 않았습니다. 대상 사이트가 반환한 403은 body 내에 status: 403이 포함된 HTTP 200으로 전달됩니다.

해결 방법: 파라미터를 제거하거나 플랜에 포함된 endpoint를 호출하거나 플랜을 업그레이드하세요. 기다려도 결과가 달라지지 않으므로 Retry-After는 설정되지 않습니다. 비용은 차감되지 않았습니다. 결과는 rate_limit이며 success에 대해서만 요금이 청구됩니다.

413: 요청 본문이 너무 큼

JSON request body가 FourA 허용 한도(100 KB)보다 큽니다. body를 읽기 전에 거부되므로 응답은 JSON이 아니며 X-FourA-Request-Id가 포함되지 않습니다.

해결 방법: 더 작은 data 페이로드를 보내세요. 비용은 차감되지 않았습니다.

429: 전송률 제한됨

서로 다른 두 검정에서 429로 응답하며, 포함되는 필드도 서로 다릅니다.

이용 중인 플랜의 자체 제한. 응답에는 호출을 거부한 제한 종류를 명시하는 X-FourA-Limit 헤더가 설정되고 body의 reason 아래에 동일한 코드가 포함됩니다.

{
  "error": "Concurrency limit reached: your plan allows 50 simultaneous proxy request(s). Retry when an in-flight request finishes.",
  "reason": "plan_limit_concurrency",
  "documentation": "https://foura.ai/prices",
  "limit": 50,
  "in_flight": 51,
  "retry_after_seconds": 1
}

reason의 값은 plan_limit_concurrency, plan_limit_rate, plan_limit_browser_daily, plan_limit_credits 또는 plan_limit_bandwidth 중 하나입니다. 대기가 유효한 경우, 대기 시간은 retry_after_seconds 및 Retry-After header에 포함되며 retryAfter에는 포함되지 않습니다. 할당량은 초 단위가 아닌 자정(UTC)에 복구되므로, plan_limit_browser_daily에는 둘 다 포함되지 않습니다. 비용은 차감되지 않았습니다. 결과는 rate_limit이며 success에 대해서만 과금됩니다.

플랫폼의 공유 할당량. X-FourA-Limit header가 없으며 대기 시간은 retryAfter에 표시됩니다.

{
  "error": "Rate limit exceeded",
  "status": 429,
  "service": "single",
  "retryAfter": 5,
  "current": { "concurrency": 12, "rpm": 3000 },
  "limits": { "maxConcurrency": 500, "maxRpm": 3000 }
}

current 및 limits은 사용자 계정이 아닌 전체 트래픽에 대한 서비스 상태를 나타냅니다. 여기서 거부된 것은 FourA 서버가 혼잡함을 의미합니다.

해결 방법: 응답에 포함된 Retry-After, retry_after_seconds, retryAfter 중 표시된 시간 동안 대기하십시오. 동시성 또는 rate limit의 경우 거부된 배치를 재전송하지 말고 열려 있는 request 수를 제한하십시오. 일일 또는 결제 주기 한도인 경우 실행을 중단하십시오. 모든 필드는 Rate Limits를, 패턴은 병렬 Request 실행를 참조하십시오.

500: 서버 오류

서버 측에서 문제가 발생했습니다.

해결 방법: 잠시 후 request를 재시도하십시오. 오류가 지속되면 상태 페이지를 확인하거나 실패한 응답의 X-FourA-Request-Id와 함께 고객지원팀에 문의하십시오.

502: 업스트림 사용 불가

FourA가 자체 엔진으로부터 응답을 받지 못했거나(Upstream unavailable: 연결 실패), 읽을 수 없는 응답을 받았습니다(Malformed JSON from backend).

{
  "error": "Upstream unavailable",
  "details": "..."
}

해결 방법: 짧은 백오프 후 재시도하세요. 이 문제는 당사 측에 있으므로 비용이 청구되지 않습니다. 결과는 service_error이며 success에만 요금이 부과됩니다.

504: 업스트림 시간 초과

엔진이 이 요청에 대한 제한 시간 내에 완료되지 않았습니다.

{
  "error": "Upstream timeout",
  "details": "the backend did not finish inside the time budget for this request"
}

504 오류는 작업 소요 시간에 관한 문제이며, API 키, 파라미터, proxy 설정과는 관련이 없습니다. 주로 대상 사이트의 응답 지연, cold challenge 해결 지연, 대용량 페이지 등이 원인입니다.

해결 방법: request의 timeout_ms 값을 늘리거나(Single 모드는 최대 120000, Browser 모드는 최대 120000, Auto 모드는 최대 180000까지 지원) 다시 시도하십시오. FourA는 설정된 제한 시간에 약간의 여유 시간을 더해 대기하므로, 시간을 늘리면 실제로 더 긴 대기 시간이 확보됩니다.

503: 서비스 비활성화 또는 용량 초과

503 오류는 유지보수로 인해 일시적으로 서비스를 사용할 수 없거나 플랫폼 동시 실행 한도가 초과되었음을 의미합니다. 두 경우 모두 동일한 키(error, status, service, retryAfter, current, limits)를 반환합니다. 필드 존재 여부가 아니라 error 문자열을 통해 두 상황을 구분하십시오.

{
  "error": "Service disabled",
  "status": 503,
  "service": "single",
  "retryAfter": 60,
  "current": { "concurrency": 0, "rpm": 0 },
  "limits": { "maxConcurrency": 500, "maxRpm": 3000 }
}

Service disabled 값은 유지 관리 상태를 나타내며, 측정이 시작되기 전에 request가 거부되었으므로 두 카운터 모두 current에 0로 표시됩니다. Service at capacity 값은 동시성 형태를 나타내며, 이 경우 current에 플랫폼의 실제 사용량이 포함됩니다. 해당 형식에 대한 자세한 내용은 Rate Limits를 참고하십시오.

해결 방법: retryAfter초 동안 대기한 후 다시 시도하십시오. 상태 페이지에서 진행 중인 유지 관리 작업을 확인할 수 있습니다.

세 번째 503 형식에는 retryAfter 항목이 없습니다. 이는 endpoint 뒤의 엔진이 호출을 처리할 수 없었음을 의미합니다. 엔진이 재시작 중이었거나, request가 실행되기 전에 FourA 측에서 오류가 발생했거나, Browser 환경에서 페이지가 대기하는 10초 동안 모든 브라우저가 사용 중인 상태였습니다. backend_status 항목은 엔진 자체의 상태를 나타내며 detail 항목은 응답의 시작 부분을 나타냅니다.

{
  "error": "Backend service unavailable",
  "backend_status": 503,
  "detail": "..."
}

service_error 상태이며 요금이 청구되지 않습니다. 1~2초 후 다시 시도하십시오. 요청 자체에 오류가 있는 경우에는 이 응답이 발생하지 않으며, 필드명을 명시하는 400 에러를 반환합니다.

네 번째 503 에러는 데이터베이스 전환 등의 이유로 FourA가 일시적으로 API key를 확인할 수 없음을 의미합니다. 사용자 key의 문제가 아니며 아무것도 실행되지 않았습니다. 해당 응답은 Retry-After: 5 및 retryAfter의 동일한 대기 시간을 포함합니다.

{
  "error": "API key check temporarily unavailable",
  "status": 503,
  "retryAfter": 5
}

과금되지 않습니다. retryAfter초 후에 다시 시도하십시오. FourA가 지난 10분 내에 확인한 키는 이러한 상황에서도 계속 작동하므로 이 응답은 드뭅니다.

/api/auto/에서 실패 읽기

POST /api/auto/은 모든 렁(rung)이 실패하더라도 래더가 실행된 경우 항상 HTTP 200으로 응답합니다. 실제 결과는 본문에 포함됩니다:

{
  "status": 403,
  "error": "exit blocked by the target defense",
  "attempts": 7,
  "meta": { "rung": "fail", "solved": false, "attempts": 7, "credits": 47 }
}

status은 타깃이 마지막으로 응답한 상태 코드이거나, 어떤 시도도 타깃에 도달하지 못한 경우 502입니다 (시간 예산이 먼저 소진된 경우는 504). 실행된 래더에서 발생한 모든 실패 응답에는 시도 중 발생한 문제를 집계하는 attemptReport가 포함되며, 로그에 기록해도 안전한 한 줄짜리 summary와 함께 호출이 전송한 내용을 나타내는 meta.attemptsByEngine 및 meta.browserRequests이 제공됩니다. Auto 호출이 실패한 이유를 참고하십시오. Auto에서 허용할 수 없는 요청 필드(예: 5000 미만 또는 180000 초과의 timeout_ms)도 동일한 방식으로 반환됩니다. 어떤 시도도 수행되지 않고 비용 청구 없이, "status": 400 및 error에 사유가 담긴 HTTP 200이 반환됩니다.

따라서 Auto에서는 전송 상태 코드를 기준으로 분기하지 마십시오. 대신 body에서 status 및 error를 확인하십시오. /api/auto/에서 반환되는 실제 non-200은 래더가 시작되기 전에 FourA가 호출을 거부했거나 완료할 수 없었음을 의미합니다: 400 (잘못된 형식의 JSON, 비공개 또는 예약된 타깃, 또는 FourA 자체 API 호스트의 타깃), 401, 413, 502, 503 또는 504. 플랜 한도 중 하나는 입구에서 즉시 처리됩니다. 프리미엄 출구가 없는 플랜에서의 exitClass: premium는 어떠한 작업도 수행되기 전에 X-FourA-Limit: plan_limit_premium와 함께 403을 받습니다. 사용자 또는 플랫폼의 다른 모든 한도는 body의 상태 코드와 함께 200 응답 내부로 반환됩니다.

특정 사이트에서 사용자의 API 키로 생성된 여러 Auto 호출이 연속으로 실패하면, Auto는 한동안 재시도하지 않고 해당 키의 다음 호출에 즉시 응답합니다: "error": "target temporarily unservable, retry later", "status": 503 및 초 단위의 retryAfter. 비용은 청구되지 않으며, retryAfter초 동안 대기하십시오.

하위 호출 중 하나에서 도달한 플랜 한도 역시 HTTP 200으로 반환됩니다. body는 거부 자체의 내용이며, 해당 reason과 함께 status 및 meta가 포함되고, 응답에는 직접 거부와 동일한 X-FourA-Limit 헤더가 포함됩니다:

{
  "status": 429,
  "error": "Credit limit reached: 75,000 of 75,000 credits used this billing period. Upgrade your plan or wait for the reset.",
  "reason": "plan_limit_credits",
  "documentation": "https://foura.ai/prices",
  "used": 75000,
  "hard_stop": 75000,
  "retry_after_seconds": 86400,
  "resets_at": "2026-10-01T00:00:00.000Z",
  "meta": { "rung": "fail", "solved": false, "attempts": 1, "credits": 0 }
}

어떤 제한이 사다리 전체를 중단하고 어떤 제한이 특정 단계만 닫는지는 Smart Fetch (Auto)에서 다룹니다.

200 OK 내부의 타깃 측 실패

모든 실패가 2xx가 아닌 HTTP 상태 코드로 나타나는 것은 아닙니다. 타깃이 HTTP 200으로 응답하더라도 FourA의 응답에 error이 포함되거나(예: validate 규칙이 본문을 거부한 경우) 본문이 FourA에서 인식하는 확인 페이지인 경우 결과는 application_error이 됩니다. 타깃이 validate 규칙에서 허용하지 않는 200 이외의 상태를 반환하면 결과는 application_fail이 되며 본문은 변경 없이 그대로 전달됩니다.

두 경우 모두 비용이 청구되지 않으며, success에 대해서만 청구됩니다. 모든 브라우저가 사용 중인 상태에서 브라우저 호출이 발생하면 브라우저가 확보될 때까지 최대 10초 동안 대기합니다. 브라우저가 확보되지 않으면 위에서 설명한 503 Backend service unavailable로 반환됩니다. 브라우저 호출 시 브라우저를 전혀 확보하지 못한 경우에도 HTTP 200과 함께 "error": "No available browser slot"을 반환할 수 있습니다. 둘 다 비용이 청구되지 않습니다. 몇 초 후 재시도하거나 동시에 열려 있는 브라우저 호출 수를 줄이십시오. 전체 분류는 Outcomes 레퍼런스에서 다룹니다.

고정된 proxy를 통한 단일 호출에서도 본문과 함께 HTTP 200 및 "error": "The exit gave the same answer for <n> different sites"이 반환될 수 있습니다. FourA는 해당 출구가 관련 없는 사이트들에도 동일한 페이지를 전달하는 것을 감지했으므로, 해당 페이지는 요청한 사이트가 아닌 출구 자체의 페이지입니다. 이는 application_error에 해당하며 비용이 청구되지 않습니다. 이러한 출구를 자동으로 건너뛰는 POST /api/proxy/를 통해 새 출구를 확보하십시오.

사이트 대신 출구 자체의 네트워크가 응답하는 경우에도 동일하게 적용됩니다. 호출은 "error": "The exit answered instead of the site (<name>)" 또는 "error": "Corporate web gateway intercepted the request (<name>)"(로그인/필터링 페이지 또는 해당 페이지로의 리디렉션), 출구가 사이트를 대신하여 직접 응답한 경우 "error": "The exit intercepted TLS and answered instead of the site (<name>)", 출구가 자체 요청의 복사본을 반환한 경우 "error": "Honeypot echo proxy (plaintext request dump)"과 함께 반환됩니다. FourA는 validate 규칙 설정과 무관하게(returnBuffer 다운로드 포함) 이를 검사합니다. 모두 비용이 청구되지 않습니다. 동일한 방식으로 새 출구를 확보하십시오.

응답 인코딩

FourA는 응답 본문을 UTF-8로 자동 디코딩합니다. 타깃이 windows-1251, gbk, shift_jis, iso-8859-* 또는 Content-Type 헤더나 HTML <meta charset> 태그에 선언된 기타 문자 집합을 제공하는 경우, data(single, proxy) 또는 body(browser) 필드에서 정제된 UTF-8 문자열을 수신합니다.

바이너리 페이로드(이미지, protobuf, 원시 오디오)의 경우 요청에 returnBuffer: true를 설정하십시오. 그러면 Single 및 Proxy는 문자 집합 트랜스코딩 없이 원시 바이트를 담은 객체인 data({"type": "Buffer", "data": [<byte values>]})를 반환합니다.

재시도 전략

실용적인 재시도 정책:

import time
import requests

# Plan limits that no short wait will clear: stop the run instead of retrying.
STOP_ON = {
    "plan_limit_feature",
    "plan_limit_premium",
    "plan_limit_browser_daily",
    "plan_limit_credits",
    "plan_limit_bandwidth",
}

def make_request(url, payload, api_key, max_retries=3):
    for attempt in range(max_retries):
        resp = requests.post(
            url,
            headers={"X-API-Key": api_key, "Content-Type": "application/json"},
            json=payload,
        )
        if resp.status_code == 200:
            return resp.json()

        body = resp.json() if resp.headers.get("content-type", "").startswith("application/json") else {}
        request_id = resp.headers.get("X-FourA-Request-Id", "?")

        limit = resp.headers.get("X-FourA-Limit")
        if limit in STOP_ON:
            raise RuntimeError(f"{limit} (request {request_id}): {body.get('error')}")

        # Plan limits send Retry-After and retry_after_seconds; platform limits send retryAfter.
        header = resp.headers.get("Retry-After")
        retry_after = (
            int(header) if header and header.isdigit()
            else body.get("retry_after_seconds") or body.get("retryAfter") or 2 ** attempt
        )

        if resp.status_code in (429, 503):
            time.sleep(retry_after)
            continue
        if resp.status_code >= 500:   # 500, 502, 503, 504 are all ours to fix
            time.sleep(2 ** attempt)
            continue

        # 400/401/403/404 won't fix themselves
        raise RuntimeError(f"{resp.status_code} (request {request_id}): {body.get('error')}")

    raise RuntimeError(f"Exhausted {max_retries} retries")

프록시 실패 시 리포트 포함

시도 횟수를 모두 소진한 POST /api/proxy/ 호출은 HTTP 오류 코드가 아닌 오류 envelope이 포함된 HTTP 200으로 반환됩니다. 오류 문자열은 짧고 항상 동일한 형태이므로, 횟수 정보가 담긴 attemptReport 객체가 함께 전달됩니다:

{
  "error": "Download maxTry limit reached",
  "attemptReport": {
    "total": 25,
    "noResponse": 0,
    "defense": 0,
    "contentRejected": 25,
    "statusRejected": 0,
    "other": 0,
    "vendors": [],
    "profilesTried": ["default"],
    "summary": "25 attempt(s): 25 returned HTTP 200 with no defense present and were rejected only by your validate.data - the page was fetched, your content rule did not match it"
  },
  "total": 34.812
}

오류 옆에 attemptReport.summary 항목을 기록하면 출구 노드가 차단되었는지, 응답이 없는지, 또는 사용자가 직접 설정한 validate 규칙에 의해 페이지가 거부되었는지 파악할 수 있습니다. 각 카운트에 대한 필드 참조 및 조치 방법: 프록시 요청의 재시도 횟수가 소진된 이유.

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