API Endpoint 레퍼런스
요청 파라미터 및 응답 형식을 포함한 모든 FourA API endpoint 레퍼런스입니다.
기본 URL
https://eu.api.foura.ai/api
인증
모든 request에는 X-API-Key header에 API 키가 포함되어야 합니다.
curl -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"}'
Dashboard에서 API 키를 생성하고 관리할 수 있습니다. 키는 pk_live_ 접두사를 사용합니다.
Response Headers
/api/*의 응답에는 두 개의 상관관계 헤더가 포함됩니다.
| Header | Value | Description |
|---|---|---|
X-FourA-Request-Id |
UUID | request에 할당된 고유 ID입니다. FourA가 전혀 읽을 수 없는 본문을 제외하고 4xx 및 5xx를 포함한 모든 응답에서 반환됩니다. 400 Invalid JSON in request body 및 413는 ID가 할당되기 전에 거부됩니다. 사용자 측에 이를 기록하십시오. |
X-FourA-Credits |
integer | 이 request에 사용된 크레딧입니다. 성공이든 실패이든 엔진에 도달한 모든 응답에 반환됩니다(어느 쪽이든 작업이 수행됨). 엔진이 실행되기 전에 FourA가 거부한 호출(누락되거나 유효하지 않은 키, 플랜 또는 플랫폼 제한, 거부된 대상 또는 proxy ID)에는 포함되지 않습니다. 과금 대상 결과는 Request Outcomes를 참조하십시오. |
동일한 request ID는 Dashboard의 Activity Log(24시간 보관, 키당 최근 200개)에서 request 및 response 페이로드 미리보기의 키 역할을 하므로, 나중에 정확한 request를 조회하고 Activity에서 Playground로 직접 재실행할 수 있습니다. 고객 지원팀에 문의할 때 이 ID를 포함하면 몇 초 안에 해당 request를 특정할 수 있습니다.
$ 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/2 200
content-type: application/json
x-foura-request-id: 8f3e2a14-7b6c-4d1a-9e2f-5a3b8c1d4e7f
x-foura-credits: 2
...
전체 목록 및 사용 팁은 Response Headers를 참고하십시오.
엔드포인트
MCP를 통해 이 엔드포인트들을 사용하시나요?
@fouradata/mcp서버는 동일한 입력 형식과 토큰 효율적인 대용량 응답 처리를 위한offload_large옵트인을 포함하여 4개 엔드포인트 모두를 네이티브 MCP 도구(foura_auto,foura_single,foura_proxy,foura_browser)로 래핑합니다. 차이점은foura_browser에는lean필드가 없으며,foura_proxy는 아직 출구 위치 필드를 지원하지 않습니다.
FourA는 각각 다른 시나리오에 최적화된 4개의 요청 엔드포인트를 제공합니다.
| 엔드포인트 | 권장 용도 |
|---|---|
POST /auto/ |
스마트 페치. URL을 전달하면 FourA가 동작하는 가장 저렴한 경로(로테이션 프록시 또는 브라우저, forceProxy: false를 사용한 직접 요청 포함)를 선택하고 호스트별로 성공한 방식을 기억합니다. |
POST /single/ |
빠른 HTTP 요청, 정적 페이지, API |
POST /proxy/ |
자동 프록시 로테이션이 적용되는 보호된 사이트, 대상에 표시되는 국가 범위 지정(선택 사항) |
POST /browser/ |
JavaScript 렌더링 페이지, SPA |
GET /profiles |
single 및 proxy용 브라우저 프로필 카탈로그. 공개 엔드포인트이며 API 키가 필요하지 않습니다. |
각 엔드포인트를 선택하는 시점에 대한 자세한 안내는 올바른 엔드포인트 선택 및 스마트 페치 가이드를 참고하십시오.
대상 URL 제한
사설, 루프백 또는 예약된 IP 범위(RFC 5735, RFC 6598, IPv6 예약 블록)로 확인되는 대상은 요청이 FourA를 떠나기 전에 400 오류와 함께 거부됩니다. 공용 호스트 이름 및 IP만 전달됩니다.
{ "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." }
FourA 자체 API 호스트(eu.api.foura.ai 또는 api.foura.ai)를 가리키는 대상 역시 아무것도 가져오거나 과금하기 전에 4개 endpoint 전체에서 400으로 거부됩니다. 공백이나 제어 문자가 포함된 URL도 Single, Proxy, Auto에서 동일하게 400으로 거부됩니다. 공백은 %20로 인코딩하세요(Browser는 Chrome과 동일한 방식으로 가져옵니다). 여기서 FourA가 가져오는 유일한 페이지는 /inspect입니다.
{ "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." }
Smart Fetch (자동)
POST /api/auto/
URL과 선택적 validate 규칙을 전달합니다. FourA는 비용을 고려한 단계별 방식(순환 프록시, 이후 전체 브라우저)을 거치며 사용자의 규칙이 수락하는 응답을 반환하는 첫 번째 단계에서 중단합니다. forceProxy: false를 사용하면 비용이 적게 드는 직접 프로브가 먼저 실행됩니다. 동일한 호스트에 대한 반복 호출 시 웜 세션이 대신 재생되므로 두 번째 요청은 비용이 저렴합니다.
재시도, 풀 크기 또는 프록시 수를 직접 조정할 필요가 없습니다. FourA가 호스트별로 학습합니다.
요청 본문
| 매개변수 | 유형 | 필수 여부 | 기본값 | 설명 |
|---|---|---|---|---|
url |
string | 예 | - | 대상 URL |
method |
string | 아니요 | "GET" |
HTTP 메서드 |
headers |
[string, string][] | 아니요 | - | [이름, 값] 쌍 형태의 대상 전송용 헤더입니다. 브라우저 단계를 제외한 모든 단계에서 전송합니다. 전송한 Cookie는 변경 없이 대상 사이트에 도달하며, 저장된 세션의 쿠키는 전송하지 않은 이름에 한해서만 함께 추가됩니다. 저장된 세션의 userAgent는 사용자의 User-Agent를 대체합니다. 프록시 단계에서는 validate.status.accept에 304가 나열되어 있지 않는 한 If-None-Match와 같은 조건부 헤더를 제외합니다. |
data |
any | 아니요 | - | GET 이외의 요청에 대한 요청 본문 |
validate |
object | 아니요 | - | 단일 요청의 validate와 동일한 형태의 성공 기준입니다 (아래 참조). 시스템이 챌린지 페이지와 실제 콘텐츠를 구분할 수 있도록 실제 페이지 형태를 정의합니다. |
returnSession |
boolean | 아니요 | true |
/api/single/ 또는 /api/browser/를 통해 다시 재생할 수 있도록 응답에 성공 세션(proxy, cookies, userAgent)을 포함합니다. |
forceProxy |
boolean | 아니요 | true |
항상 순환 프록시를 통해 라우팅합니다. 대상이 허용할 때 비용이 더 저렴한 직접 경로를 사용할 수 있도록 false로 설정합니다 (일부 방어 체계는 프록시 트래픽에 더 엄격합니다). |
timeout_ms |
integer | 아니요 | 120000 |
전체 호출에 대한 총 시간 예산(밀리초)입니다. 모든 하위 시도는 이 예산 내에서 실행됩니다. 최소 5000, 최대 180000. |
ignoreProxies |
string[] | 아니요 | - | 모든 하위 시도에서 제외할 프록시 ID 목록입니다. 이전 /api/auto/ 또는 /api/proxy/ 응답에서 반환된 ID를 사용합니다. |
followRedirects |
integer | 아니요 | 5 |
비용이 적은 단계에서 따를 최대 리디렉션 수입니다. 비활성화하려면 0. 최대 20. |
exitClass |
string | 아니요 | - | Proxy Request에서와 동일하게 standard 또는 premium를 사용합니다. premium는 표준 풀로 페이지에 도달할 수 없을 때 프리미엄 출구로 호출을 에스컬레이션하도록 허용합니다. 프리미엄 출구가 포함된 플랜이 필요합니다. exitClass on Smart Fetch를 참조하세요. |
응답
{
"status": 200,
"data": "<!doctype html>...",
"headers": [{"content-type": "text/html"}],
"meta": {
"rung": "cache",
"solved": false,
"attempts": 1,
"credits": 2,
"attemptsByEngine": {"single": 1, "proxy": 0, "browser": 0},
"browserRequests": 0
},
"session": {
"proxy": "A1B2C3",
"cookies": [{"name": "session", "value": "abc", "domain": "example.com"}],
"userAgent": "Mozilla/5.0..."
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
status |
number | 대상의 HTTP 상태 코드입니다. |
data |
string | 응답을 제공한 단계에 관계없이 텍스트로 반환된 응답 본문입니다. JSON 페이지는 JSON 텍스트로 반환되므로 직접 파싱해야 합니다. |
headers |
array or object | 대상 응답 헤더입니다. 단일 및 proxy 단계는 홉별 헤더 객체 배열을 반환하며, browser 단계는 평면 객체를 반환합니다. |
meta.rung |
string | 응답을 전달한 사다리 단계입니다. 다음 중 하나입니다: probe (forceProxy: false 전용 저비용 직접 요청), proxy (회전 proxy), browser (전체 브라우저 렌더링), cache (웜 세션 재생), warmup (사이트 진입 페이지를 먼저 가져오고 해당 쿠키로 딥 URL을 연 경우), 또는 fail (어떤 단계도 허용된 응답을 생성하지 못함). |
meta.solved |
boolean | 페이지에 추가 단계(챌린지 페이지)가 필요했는지, 그리고 이 호출 중에 완료되었는지 여부입니다. |
meta.attempts |
number | 성공 전까지 시도한 하위 시도 횟수입니다. |
meta.credits |
number | 이 호출에 사용된 총 크레딧입니다. X-FourA-Credits와 일치합니다. |
meta.attemptsByEngine |
object | single, proxy 및 browser로 전송된 요청입니다. 플랜에서 거부된 브라우저 요청도 전송되었으므로 계산에 포함됩니다. |
meta.browserRequests |
number | 일일 한도 슬롯을 차지한 브라우저 요청 수입니다. 플랜에서 거부된 브라우저 요청은 슬롯을 차지하지 않습니다. |
meta.exitClass |
string | 전달된 출구 클래스이며, 요청에서 exitClass를 지정한 경우 존재합니다: premium 또는 standard. 동일한 값이 X-FourA-Exit-Class 응답 헤더로 전달됩니다. |
session.proxy |
string | 응답을 전달한 proxy의 인코딩된 ID입니다. 단일 또는 브라우저 요청에서 재사용할 수 있습니다. returnSession가 true일 때 존재합니다. |
session.cookies |
array | 재현할 쿠키 목록이며, 각 쿠키는 최소 name 및 value를 포함합니다. browser 단계는 브라우저의 쿠키 저장소를 반환합니다. proxy 단계 또는 직접 프로브는 페이지를 연 쿠키만 반환하며(사이트 확인 페이지가 설정한 쿠키 등), 페이지가 설정한 모든 쿠키를 반환하지는 않으므로 목록이 비어 있을 수 있습니다. returnSession가 true일 때 존재합니다. |
session.userAgent |
string | 성공한 시도에 사용된 User-Agent입니다. returnSession가 true일 때 존재합니다. |
error |
string | 호출 실패 시 오류 메시지입니다. |
attemptReport |
object | 실패한 호출의 경우: 원인별로 페이지 없이 반환된 엔진 요청입니다. Smart Fetch를 참고하십시오. |
예제
curl -X POST https://eu.api.foura.ai/api/auto/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/product/42",
"validate": {"data": {"accept": ["Add to cart"]}}
}'
참고 사항
- Auto는 코디네이터입니다. 내부적으로 Single, Proxy 또는 Browser를 호출하며 각 하위 호출에 API 키를 전달합니다. Auto 호출은 하위 호출 크레딧의 합계와 함께 Activity Log 및 Overview에 단일 request로 기록됩니다. 하위 호출은 해당 호출의 시도로 하위에 나열되며, 개별 request로 계산되지 않습니다.
- 실제 페이지만 포함하는 하위 문자열을
validate.data.accept에 전달하십시오. 이 값이 없으면 Auto는 실제 200 응답과 상태 코드 200으로 반환된 챌린지 중간 페이지를 구별할 수 없습니다. - 삭제된 페이지는 사이트의 정상 응답이며 거부가 아닙니다. 두 개의 출구 노드가 동일한
404또는410을 반환하고validate이 이를 수락하지 않는 경우, 호출은 해당status및the site answered로 시작하는error과 함께 종료됩니다.validate.status.accept에 상태 코드를 지정하면 Auto는 나머지validate조건을 통과하면서 해당 상태 코드를 가진 첫 번째 응답을 전달합니다. 사이트가 챌린지 페이지와 함께 전송하기도 하는403,429,503및202을 제외하고 여기에 나열된 다른 모든 상태 코드에도 동일하게 적용됩니다. timeout_ms은 전체 호출의 상한을 설정합니다. 보호된 사이트에 대한 첫 번째 콜드 호출은 수십 초가 걸릴 수 있지만, 재사용된 웜 세션은 일반적으로 1초 미만으로 완료됩니다.
Smart Fetch의 exitClass
exitClass는 Proxy Request에서와 마찬가지로 Smart Fetch에서도 지시가 아닌 허용 범위로 동작합니다. Auto는 표준 풀을 먼저 시도합니다. 표준 풀이 페이지에 도달할 수 없고 요청에 premium이 지정된 경우, Auto는 프리미엄 출구를 통해 브라우저에서 페이지를 엽니다. 여기서 생성된 세션은 동일하게 premium을 지정하는 동일 사이트 대상의 후속 호출에 재사용됩니다. 이를 지정하지 않은 호출은 해당 세션을 사용하지 않습니다.
소진은 오류가 아닙니다. 청구 주기 동안 플랜의 프리미엄 트래픽이 모두 사용되면 호출은 표준 풀에서 계속 진행되며 meta.exitClass는 standard을 표시합니다. 프리미엄 출구가 없는 플랜에서 exitClass: premium를 전송하는 호출은 어떤 작업도 수행하기 전에 X-FourA-Limit: plan_limit_premium이 포함된 403로 거부됩니다.
프리미엄 트래픽은 Proxy Request와 동일한 방식으로 측정됩니다. 브라우저에서 열린 페이지는 페이지 자체보다 더 많은 리소스를 로드하므로, 프리미엄 Smart Fetch 페이지는 Proxy Request로 가져온 동일한 페이지보다 더 많은 프리미엄 트래픽을 사용합니다. 이를 최소화하기 위해 프리미엄 Smart Fetch 페이지는 이미지, 폰트, 미디어 및 알려진 광고, 분석, 동의 제공업체의 스크립트 없이 로드됩니다.
Single Request
POST /api/single/
실제 브라우저를 구동하지 않고 실제 브라우저와 유사한 유선 특성을 갖춘 HTTP request를 전송합니다. 가장 빠른 endpoint입니다.
요청 본문
| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
method |
string | 예 | - | HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS |
url |
string | 예 | - | 대상 URL. 캐시 무효화를 위해 현재 타임스탬프를 삽입하려면 URL 내 어디서든 {ts}를 사용하십시오. |
headers |
[string, string][] | 아니요 | - | [name, value] 쌍 형태의 커스텀 header |
unblocker |
boolean | 아니요 | true |
실제 브라우저 header 전송 (User-Agent, Sec-Ch-Ua, Sec-Fetch-*, Accept-Encoding). 기본적으로 활성화되어 있습니다. false로 설정하면 FourA는 브라우저 header를 추가하지 않고 전달된 것만 보냅니다. |
timeout_ms |
number | 아니요 | 15000 | 전체 timeout (ms, 최대: 120000) |
connect_timeout_ms |
number | 아니요 | 5000 | 연결 timeout (ms) |
accept_timeout_ms |
number | 아니요 | 5000 | Accept timeout (ms, 연결 수락 대기 시간) |
server_response_timeout_ms |
number | 아니요 | 15000 | 서버 response timeout (ms, 첫 바이트 수신 대기 시간) |
dns_cache_timeout_sec |
number | 아니요 | 120 | DNS 캐시 TTL (초, 최대: 240) |
followRedirects |
number | 아니요 | disabled | 따라갈 최대 리디렉션 횟수 (0-20). 비활성화하려면 생략하십시오. |
tryJsonData |
boolean | 아니요 | false | 가능한 경우 response body를 JSON으로 파싱 |
returnBuffer |
boolean | 아니요 | false | 디코딩된 문자열 대신 원본 버퍼 반환 |
data |
any | 아니요 | - | Request body (문자열 또는 객체, JSON으로 자동 직렬화됨) |
proxy |
string | 아니요 | - | 동일한 출구를 고정하기 위한 이전 response의 proxy ID. 불투명 문자열을 그대로 다시 전달하십시오. 원시 proxy 주소는 400 Invalid proxy format와 함께 거부됩니다. 일부 ID는 고정할 수 없습니다: 출구 고정하기를 참고하십시오. |
browser |
string | 아니요 | Chrome | 모방할 브라우저: Chrome, Edge, Safari, Firefox 또는 Tor. 브라우저 프로필을 참고하십시오. |
os |
string | 아니요 | - | 모방할 운영체제: Windows, macOS, Android 또는 iOS. 제품군 이름을 입력하면 해당 제품군의 모든 버전이 허용됩니다. |
version |
string | 아니요 | newest | 카탈로그에 나열된 모방할 브라우저 버전. 여러 버전이 일치하는 경우 최신 항목이 선택됩니다. |
profile |
string | 아니요 | - | 위 세 필드 대신 사용하는 GET /api/profiles의 정확한 프로필 ID. |
validate |
object | 아니요 | - | Response 유효성 검사 규칙 (아래 참조) |
브라우저 프로필
기본적으로 request는 최신 Google Chrome을 나타냅니다. 일부 대상은 특정 브라우저는 허용하고 다른 브라우저는 거부하므로, browser, os, version로 측정된 프로필 카탈로그 범위를 좁히고 profile로 특정 ID를 선택할 수 있습니다.
{
"method": "GET",
"url": "https://example.com",
"browser": "Firefox",
"os": "Windows"
}
규칙:
- 선택 시
unblocker설정이 필요합니다(기본값은 활성).unblocker설정을 끄면 브라우저 header가 전송되지 않으므로, 요청이 불완전하게 적용되는 대신 거부됩니다. - 여러 프로필이 일치하는 경우 최신 버전이 우선 적용됩니다.
- 카탈로그에 없는 조합은 사용 가능한 항목을 명시하는 오류를 반환하며, 알 수 없는
profileID는unknown profile '<id>'을 반환합니다. 다른 브라우저로 요청이 전송되는 경우는 절대 없습니다. - 동일한 네 개 필드는
POST /proxy/의request객체 내에서도 사용할 수 있습니다.
GET /api/profiles는 전체 카탈로그를 반환하며 API key가 필요하지 않습니다:
{
"profiles": [
{ "id": "...", "browser": "Chrome", "version": "...", "os": "...", "osFamily": "macOS" }
],
"default": "..."
}
osFamily은(는) 피커를 구성할 때 필터링 기준으로 사용할 값이며, os은(는) 표시용 릴리스 이름을 유지합니다.
유효성 검사 규칙
validate 객체를 사용하면 성공 및 실패 조건을 정의할 수 있습니다. fail 조건이 일치하면 request가 실패한 것으로 처리됩니다. accept 조건이 설정된 경우 일치하는 response만 성공한 것으로 처리됩니다.
{
"validate": {
"status": { "accept": [200, 201], "fail": [403, 503] },
"headers": { "accept": {"content-type": "application/json"} },
"data": { "accept": ["product"], "fail": ["captcha", "blocked"] }
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
validate.status.accept |
number[] | 허용할 HTTP 상태 코드 |
validate.status.fail |
number[] | 거부할 HTTP 상태 코드 |
validate.headers.accept |
object | 리다이렉트 홉 중 하나라도 최소 한 쌍이 일치하면 response가 통과합니다. 이름과 값은 대소문자를 구분하지 않으며 부분 일치를 지원합니다. |
validate.headers.fail |
object | 실패를 트리거하는 헤더 키-값 쌍 |
validate.data.accept |
string[] | body에 이 문자열 중 하나 이상이 포함되어 있으면 response가 통과합니다 |
validate.data.fail |
string[] | 실패를 트리거하는 response body의 문자열 목록 |
예시
curl -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/products",
"timeout_ms": 10000
}'
Response:
{
"status": 200,
"headers": [{"result": {"version": "HTTP/2", "code": 200, "reason": ""}, "content-type": "text/html", "server": "...", "set-cookie": ["session=abc", "tracker=xyz"]}],
"data": "<!doctype html>...",
"total_time": 0.342
}
대상 서버가 본문 도달 과정에서 봇 검사를 실행하면 response에 벤더 이름과 검사 통과 여부를 명시한 defense 객체도 포함됩니다.
{
"status": 200,
"data": "<!doctype html>...",
"total_time": 3.61,
"defense": {
"vendor": "sgcaptcha",
"solved": true,
"present": ["sgcaptcha"],
"ms": 3412,
"cookie": "_I_=<clearance>"
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
status |
number | 대상 서버의 HTTP 상태 코드 |
headers |
array | 리다이렉트 홉당 하나의 객체입니다. 각 객체에는 상태 라인 및 모든 응답 헤더가 포함된 result 필드가 있습니다. 다중 값 헤더(Set-Cookie, Link, WWW-Authenticate)는 문자열 배열로 반환됩니다. |
data |
string/object | 응답 본문(tryJsonData 설정이 true인 경우 JSON) |
total_time |
number | 총 요청 소요 시간(초) |
proxy |
string | 요청이 통과한 프록시의 인코딩된 ID(요청 시 proxy 항목이 제공된 경우에만 해당). 동일한 출구 노드를 고정하려면 후속 호출에서 재사용하십시오. |
defense |
object | 대상 서버가 이 요청에 대해 봇 검사를 실행했거나 사이트 자체 쿠키를 사용한 재시도로 본문을 가져온 경우에 표시됩니다. defense.solved 값은 검사 통과 여부를 나타내며, defense.retry 값은 재시도로 콘텐츠를 가져왔는지 여부를 나타냅니다. 모든 필드와 전체 시스템 목록은 사이트 검사를 참조하십시오. |
error |
string | 요청 실패 시의 오류 메시지 |
Proxy Request
POST /api/proxy/
실패 시 자동 재시도 기능을 통해 순환 프록시로 요청을 라우팅합니다. 선택적으로 대상 서버에 표시되는 출구 국가 범위를 지정할 수 있습니다.
요청 본문
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
request |
object | Yes | - | 단일 request body (위의 Single Request와 동일한 필드) |
timeout_ms |
number | No | 45000 | 모든 시도에 대한 전체 timeout (ms 단위, 최대: 120000) |
maxTries |
number | No | 5 | FourA는 이 횟수만큼 실패하면 새 시도 시작을 중단합니다 (최대: 90). 시도는 병렬로 실행되므로 이 수치보다 몇 개 더 완료될 수 있습니다. |
ignoreProxies |
string[] | No | - | 로테이션에서 제외할 proxy ID (이전 response에서 반환된 ID 사용) |
exitCountries |
string[] | No | - | 타깃에 표시되는 두 자리 국가 코드의 엄격한 허용 목록 (예: ["CZ", "GB"]). 값은 공백이 제거되고 대문자로 변환되며 중복이 제거됩니다. 국가를 알 수 없는 standard pool의 exit은 제외되며, standard pool은 요청되지 않은 국가로 대체되지 않습니다. premium exit 역시 나열된 국가 중 하나에서 나갑니다. |
exitClass |
string | No | - | standard 또는 premium. premium 설정을 사용하면 standard pool이 보호된 타깃에서 처리에 어려움을 겪을 때 요청이 premium exit으로 에스컬레이션될 수 있습니다. premium exit이 포함된 플랜이 필요합니다. |
exitState |
string | No | - | exit이 나가는 지역. exitClass: premium 및 exitCountries 내 정확히 하나의 국가가 필요합니다. Exit location을(를) 참조하십시오. |
exitCity |
string | No | - | exit이 나가는 도시. exitClass: premium 및 exitCountries 내 정확히 하나의 국가가 필요합니다. |
exitAsn |
string | No | - | exit이 나가는 네트워크 (AS 번호 기준, 예: 8866). exitClass: premium 및 exitCountries 내 정확히 하나의 국가가 필요합니다. |
exitOs |
string | No | - | windows, android, ios 또는 mac: 주소가 속한 디바이스 유형. exitClass: premium이(가) 필요합니다. |
exitLifetimeMin |
integer | No | - | exit이 주소를 유지하는 시간(분), 3 ~ 1440. exitClass: premium이(가) 필요합니다. |
exitCountries 범위 지정
선택 시 타깃에 표시되는 최신 국가 메타데이터가 사용되며, 일반적으로 약 10분 이내에 갱신됩니다. 이는 request 중 실시간 위치 조회가 아닙니다. proxy host 주소로 서비스 제공 국가를 유추하지 마십시오.
현재 pool에 요청된 국가와 일치하는 항목이 없고 request에 exitClass: premium이(가) 지정되지 않은 경우, response는 오류 envelope와 함께 HTTP 200을 반환합니다.
{
"error": "No eligible proxy found for exit countries: CZ, GB",
"code": "no_eligible_proxy",
"details": { "exitCountries": ["CZ", "GB"] },
"total": 0.084
}
요청된 범위를 유지하고 나중에 다시 시도하십시오. 워크플로의 국가 요구사항이 명시적으로 변경되는 경우에만 범위를 변경하거나 확장하십시오.
예시
curl -X POST https://eu.api.foura.ai/api/proxy/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"maxTries": 3,
"exitCountries": ["CZ", "GB"],
"request": {
"method": "GET",
"url": "https://example.com/prices"
}
}'
Response:
{
"status": 200,
"headers": [{"result": {"code": 200}, "content-type": "text/html", "set-cookie": ["a=1", "b=2"]}],
"data": "<!doctype html>...",
"total_time": 1.204,
"proxy": "A1B2C3",
"exitCountry": "CZ",
"total": 2.341
}
| 필드 | 타입 | 설명 |
|---|---|---|
proxy |
string | 사용된 proxy의 인코딩된 식별자입니다. Single 또는 Browser request에서 proxy 필드로 전달하여 재사용하거나, ignoreProxies를 통해 다음 Proxy request에서 제외할 수 있습니다. |
exitCountry |
string | request를 처리한 proxy의 대상 표시 2자리 국가 코드입니다. 출구 클래스에 관계없이 request에 exitCountries가 설정된 경우에만 표시됩니다. response를 신뢰하기 전에 항상 요청한 코드 중 하나인지 확인하십시오. |
exitClass |
string | request를 처리한 출구 클래스이며, request에서 지정한 경우 성공한 response에 표시됩니다. premium는 프리미엄 출구가 body를 반환했음을 의미하고, standard는 표준 풀이 반환했음을 의미합니다. 실패한 호출은 아무것도 처리하지 못했으므로 exitClass를 포함하지 않습니다. 시도 과정에서 발생한 문제는 attemptReport를 확인하십시오. |
total |
number | 외부 총 소요 시간(초, float)입니다. proxy 선택, 재시도 및 성공한 시도가 포함됩니다. total_time는 내부 request 전용이며, total는 항상 total_time 이상입니다. |
profile |
string | 로테이션이 선택한 브라우저 프로필이며, 요청한 프로필과 다른 경우에만 표시됩니다. 표시되지 않으면 작성된 그대로 request가 전송되었음을 의미합니다. 정상 작동한 브라우저를 유지하려면 후속 호출에서 해당 ID를 profile로 다시 전달하십시오. |
error |
string | request 실패 시 오류 메시지입니다. 범위 불일치 시 code는 no_eligible_proxy이며, details.exitCountries에는 정규화된 범위가 그대로 반영됩니다. |
attemptReport |
object | 실패한 모든 Proxy 호출에 표시됩니다. 차단된 풀, 비활성 풀, 일치하지 않은 validate 규칙이 모두 동일한 오류로 표시되지 않도록 각 시도에서 발생한 문제를 카운트합니다. 아래를 참조하십시오. |
request |
object | 실패한 Proxy 호출에 표시됩니다. 기본값이 채워지고 전송한 ignoreProxies가 그대로 유지된, FourA가 실행한 request입니다. |
모든 Single Request response 필드도 포함되며 defense 역시 여기에 해당합니다. 봇 감지를 만난 proxy 시도는 Single과 동일한 방식으로 이를 보고합니다.
Proxy 호출이 실패한 이유
시도 결과가 어떠하든 Download maxTry limit reached는 동일하게 표시되므로, 실패한 모든 Proxy response는 오류와 함께 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
}
| 필드 | 타입 | 설명 |
|---|---|---|
total |
integer | 시도 횟수 |
noResponse |
integer | exit 노드가 응답하지 않아 대상 사이트에 도달하지 못함 |
defense |
integer | 대상 사이트가 응답했으나 해당 응답에서 봇 감지가 확인됨 |
contentRejected |
integer | HTTP 200이며 봇 감지가 없었으나, 사용자의 validate.data 설정에 의해서만 거부됨 |
statusRejected |
integer | 대상 사이트가 응답했고 봇 감지가 없었으나, 사용자의 validate.status 설정에 의해 거부됨 |
other |
integer | 응답을 받았으나 위의 어느 항목에도 해당하지 않음 |
vendors |
string[] | 작업 내에서 확인된 봇 감지 벤더 목록 |
profilesTried |
string[] | 작업이 전송한 브라우저 프로필 목록(최초 사용 순). default(은)는 request가 변경 없이 그대로 전송되었음을 의미합니다. |
summary |
string | 집계 데이터를 바탕으로 생성된 한 문장의 요약으로, 로그 기록에 안전함 |
error 문자열은 변경되지 않으므로 이를 매칭하는 클라이언트는 정상적으로 계속 작동합니다. 각 카운트별 대처 방법: Proxy Request의 재시도 횟수가 소진된 이유.
exitClass
일부 대상 사이트는 아무리 여러 번 시도해도 표준 풀의 exit 노드를 거부합니다. exitClass: premium(은)는 Proxy가 표준 풀 내에서만 순환하는 대신 이러한 request를 표준 풀 외에 프리미엄 exit로 에스컬레이션할 수 있도록 지시합니다.
{
"exitClass": "premium",
"request": { "method": "GET", "url": "https://example.com/report" }
}
전송하기 전에 알아두어야 할 세 가지 사항이 있습니다.
이는 허용치이며 지시 사항이 아닙니다. 표준 풀이 여전히 먼저 응답을 시도하며, 보통 표준 풀이 성공합니다. 프리미엄 exit는 풀이 해당 request에 짧은 예산을 소모했거나 대상이 명백히 거부했을 때만 참여합니다. 프리미엄 exit를 시도하기 전에 표준 풀이 응답한 request는 일반 성공으로 처리되며 프리미엄 트래픽 비용이 발생하지 않습니다. 프리미엄 exit가 한 번이라도 시도되면 아래 설명된 대로 해당 트래픽이 집계됩니다.
프리미엄 exit는 exitCountries 내에 유지됩니다. 국가 목록을 지정하면 프리미엄 exit는 해당 국가 중 하나에서 나가며, 표준 풀과 마찬가지로 response의 exitCountry에 해당 국가가 표시됩니다.
response는 실제로 서비스를 제공한 주체를 알려줍니다. 클래스를 지정하면 response에 exitClass이 포함되어 반환됩니다:
{
"status": 200,
"exitClass": "premium",
"proxy": "Y2QXVK",
"data": "..."
}
premium는 프리미엄 exit이 본문을 반환했음을 의미합니다. standard는 표준 풀이 반환했음을 뜻하며, 이는 프리미엄 exit을 확보할 수 없었거나 플랜에 포함된 프리미엄 트래픽(및 추가 구매량)을 해당 결제 주기 동안 모두 소진했을 때도 반환되는 값입니다. 둘 다 오류가 아니며, 월별 수치가 아닌 요청별로 프리미엄 트래픽을 대조할 수 있습니다. 동일한 값이 X-FourA-Exit-Class response header로 전달됩니다(Response Headers 참조).
프리미엄 트래픽은 네트워크 기준으로 측정됩니다. 프리미엄 시도는 페이지 반환 여부와 관계없이 네트워크를 통과하며 압축 및 암호화된 상태로 송수신된 데이터를 모두 계산합니다. 다른 exit이 응답했을 때 아직 실행 중이던 시도는 즉시 중단되며, 해당 시점까지 발생한 트래픽도 계산에 포함됩니다. 프리미엄 트래픽은 프리미엄 허용량과 총 대역폭 모두에 반영됩니다. 즉, 동일한 바이트가 두 곳에 각각 보고되며 서로 합산되지는 않습니다. 프리미엄 exit이 페이지를 전달한 경우 해당 트래픽이 해당 요청의 전체 트래픽이 되므로, 표준 트래픽으로 중복 계산되지 않습니다. Usage & Limits 페이지에서 총 트래픽, 프리미엄 트래픽 비율, 기준이 되는 프리미엄 허용량을 확인할 수 있습니다.
해당 필드를 생략하거나 standard를 전송하면 요청이 표준 풀에 유지됩니다. premium만 프리미엄 exit을 허용합니다. 클래스를 지정한 성공적인 요청은 응답으로 exitClass를 수신하며, 필드를 생략한 요청은 이를 받지 않습니다.
허용량 소진은 오류가 아닙니다. 허용량을 소진한 후 premium를 지정한 요청도 계속 작동합니다. 표준 풀에서 요청을 처리하며 응답에는 standard가 표시됩니다. 유일한 예외는 exit location을 지정한 요청입니다. 표준 풀에서는 이를 수용할 수 없으므로 요청이 거부됩니다.
exitClass: premium는 프리미엄 exit이 포함된 플랜이 필요합니다. 해당 플랜이 아니면 요청에서 프리미엄 exit이 사용되지 않으며, 작업이 실행되기 전에 X-FourA-Limit: plan_limit_premium를 포함한 403 오류와 함께 거부됩니다(Rate Limits 참조).
출구 위치
프리미엄 exit은 특정 국가 내의 특정 위치에서 나갈 수 있으며, 필요한 기간 동안 해당 주소를 유지할 수 있습니다.
{
"exitClass": "premium",
"exitCountries": ["BG"],
"exitCity": "sofia",
"exitLifetimeMin": 15,
"request": { "method": "GET", "url": "https://example.com/" }
}
response에는 출구와 요청이 나간 국가가 명시됩니다.
{
"status": 200,
"exitClass": "premium",
"exitCountry": "BG",
"proxy": "1EM4GZY",
"data": "..."
}
해당 proxy ID가 이 모든 것을 유지합니다. 이를 Single 또는 Browser에 전달하면 다른 필드 없이도 동일한 위치에서 요청이 전송됩니다. 출구 고정을 참고하십시오.
규칙:
exitState,exitCity,exitAsn,exitOs,exitLifetimeMin중 하나라도 있으면 프리미엄 출구로만 요청을 보냅니다. 표준 풀은 이를 처리할 수 없으므로 시도조차 하지 않습니다.- 해당 필드들은
exitClass: premium이 필요합니다. 없으면 해당 필드를 명시하는 400 에러와 함께 요청이 거부됩니다. exitState,exitCity,exitAsn은 단일 국가 내에 존재하므로exitCountries에 정확히 하나의 국가만 지정해야 합니다.exitOs및exitLifetimeMin는 여러 국가를 지정할 수 있으며, 출구는 그중 하나를 선택하고 응답의exitCountry에 선택된 항목이 표시됩니다.exitState,exitCity,exitAsn,exitOs를 사용하려면 프리미엄 출구뿐만 아니라 지역 타겟팅이 포함된 요금제가 필요합니다.- 프리미엄 트래픽이 남아 있지 않으면 표준 풀에서 처리할 수 없으므로
X-FourA-Limit: plan_limit_premium가 포함된 403 에러로 요청이 거부됩니다. - 해당 위치에 응답하는 프리미엄 출구가 없으면 exitCountries 범위 지정 항목에 설명된 것과 같은 오류 envelope가 반환되며, 오류는
No premium exit answered for this request및code: no_eligible_proxy로 표시됩니다. 국가 목록을 전달한 경우details.exitCountries이 포함됩니다.
이 용어들은 proxy 포트가 state, city, asn, os에 사용하는 용어와 동일합니다.
브라우저 프로필 순환
Proxy는 출구를 순환합니다. 사이트가 요청 출처 출구가 아닌 FourA가 제시한 브라우저를 거부할 경우, Proxy는 카탈로그의 다른 브라우저 제품군으로 변경하기도 합니다. 이때 추가 시도는 발생하지 않습니다. 순환은 재시도 시 전송되는 내용을 변경할 뿐, 재시도 수행 여부 자체를 변경하지는 않습니다.
Proxy는 사이트가 최근 승인한 제품군을 일정 시간 동안 기억하므로, 동일한 사이트에 대한 후속 호출은 기본값 대신 해당 제품군으로 시작할 수 있습니다. 응답의 profile에 해당 제품군이 명시되며, 순환에 의해 선택된 모든 제품군 역시 동일하게 표시됩니다.
내부 request에 명시된 profile, browser, os 또는 version은 재정의되지 않으며, 자체 User-Agent 또는 Cookie 헤더를 포함하는 요청 역시 재정의되지 않습니다. 인증 통과는 해당 인증을 획득한 시그니처에 바인딩되기 때문입니다.
Browser Request
POST /api/browser/
Chrome 브라우저 인스턴스에서 URL을 엽니다. 페이지가 로드되고 JavaScript가 실행되며, 완전히 렌더링된 HTML 및 cookie jar를 반환합니다.
요청 본문
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url |
string | Yes | - | 대상 URL |
headers |
object | No | - | 키-값 쌍 형태의 커스텀 header |
cookies |
array | No | - | 설정할 cookie 목록: [{name, value, domain?}] |
userAgent |
string | No | - | 커스텀 User-Agent 문자열 |
unblocker |
boolean | No | true |
페이지가 로드되기 전에 요구하는 검증(챌린지 페이지 또는 유사한 게이트)을 완료합니다. 기본적으로 켜져 있습니다. 페이지가 반환하는 내용을 챌린지 페이지를 포함해 있는 그대로 렌더링하려면 false로 설정하세요. |
proxy |
string | No | - | 동일한 exit를 고정하기 위한 이전 응답의 proxy ID입니다. 불투명 문자열(opaque string)을 그대로 다시 전달하세요. 원시 proxy 주소는 400 Invalid proxy format 오류로 거부됩니다. |
timeout_ms |
number | No | 30000 | 페이지 로드 타임아웃(ms 단위, 최대: 120000) |
checkStatus |
number | No | - | 예상 HTTP 상태 코드(다를 경우 요청 실패) |
checkText |
string | No | - | 렌더링된 페이지에 반드시 포함되어야 하는 텍스트 |
lean |
boolean | No | false |
이미지, 폰트, 미디어 및 알려진 광고, 분석, 동의, 소셜 서비스로의 요청을 제외합니다. 페이지 자체, 자체 스크립트 및 스타일, 그리고 검증 단계에 필요한 모든 요소는 정상적으로 로드됩니다. 고정된 프리미엄 exit 등을 사용할 때 페이지가 소모하는 트래픽을 줄이는 데 활용하세요. |
브라우저 시계를 exit에 맞추기
페이지는 브라우저의 시간대를 읽어 파악된 IP의 국가와 비교할 수 있습니다. 불일치는 봇 탐지기가 사용하는 가장 손쉬운 신호 중 하나이며, 이를 제거하는 데 추가 비용은 들지 않습니다.
별도로 수행할 작업은 없습니다. FourA가 proxy ID에서 국가를 읽어오고, 브라우저는 해당 국가에 속한 시간대를 보고합니다.
- 프록시가 호스팅된 위치가 아니라 대상 사이트가 보게 되는 exit 국가를 기준으로 합니다. 이 둘은 유의미하게 일치하지 않는 경우가 많습니다.
- FourA가 exit 국가를 알 수 없을 때는 임의로 추측하는 대신 브라우저 시계를 그대로 유지합니다. Proxy Request에서
exitCountries로 국가를 요청한 경우 프리미엄 exit의 국가가 식별됩니다. - 시계만 해당 국가를 따릅니다.
Accept-Language및 사이트가 제공하는 콘텐츠는 변경되지 않으므로 페이지 언어가 임의로 바뀌지 않습니다.
userAgent 파라미터
userAgent를 전달하면 페이지, 워커, 대상 서버 모두 해당 문자열을 그대로 확인합니다. FourA는 여기에서 일치하는 client hints(sec-ch-ua, sec-ch-ua-platform, navigator.platform, 그리고 탐지기가 이름으로 요청하는 high-entropy 값)도 도출하므로, header와 JavaScript에서 서로 다른 브라우저를 보고하지 않습니다.
응답에 포함된 userAgent는 실제로 제시된 값입니다. 이는 통과(clearance)를 재사용할 때 중요합니다. cf_clearance cookie는 이를 획득한 exit 및 User-Agent에 바인딩되므로, 사용되었다고 생각하는 문자열이 아니라 응답이 보고한 문자열을 다시 보내야 합니다. Site checks를 참조하세요.
Chromium 기반이 아닌 문자열(예: Firefox User-Agent)을 전송하면 Chromium 브랜드 목록 없이 그대로 표시됩니다.
예시
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/spa-app",
"timeout_ms": 15000,
"checkText": "product-list"
}'
Response:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<!doctype html>...",
"cookies": [{"name": "session", "value": "abc123", "domain": "example.com", "path": "/", "expires": 1735689600, "httpOnly": true, "secure": true, "sameSite": "Lax"}],
"userAgent": "Mozilla/5.0...",
"defenseSolved": true,
"defenses": {"present": ["cloudflare"], "cleared": ["cloudflare"]}
}
| 필드 | 타입 | 설명 |
|---|---|---|
status |
number | 대상의 HTTP 상태 코드 |
headers |
object | 응답 헤더 |
body |
string or object | 완전히 렌더링된 페이지 콘텐츠. content-type이 HTML인 경우 문자열 HTML, 페이지가 JSON을 반환하여 자동 파싱된 경우 객체. |
cookies |
array | 페이지의 전체 쿠키 객체. 각 쿠키에는 name, value, domain, path, expires, httpOnly, secure, sameSite 및 기타 쿠키 속성이 포함됩니다. |
userAgent |
string | 사용된 브라우저 User-Agent |
defenseSolved |
boolean | 이번 호출에서 봇 방어를 감지하고 실제로 우회 완료한 경우 true, 그렇지 않은 경우 false. 호출 비용이 5크레딧인지 10크레딧인지 결정합니다. |
defenses |
object | present는 페이지 로드 중 인식된 모든 벤더를 나열하고, cleared은 최종 페이지가 우회 권한을 보유한 벤더를 나열합니다. 벤더가 present에만 나타나고 cleared에는 나타나지 않을 수 있습니다. 사이트 검사를 참조하세요. |
proxy |
string | 요청이 통과한 프록시의 인코딩된 ID (요청 시 proxy가 제공된 경우에만 해당). 동일한 출구를 유지하려면 후속 호출에서 이를 재사용하세요. |
error |
string | 요청 실패 시 오류 메시지 |
출구 고정
Single 또는 Browser 요청의 proxy 값은 이전 호출에서 사용된 출구를 고정합니다. 프록시 주소가 아닌 받은 그대로의 불투명 ID를 다시 전달해야 합니다. 국가, 위치 또는 수명을 지정한 Proxy 요청의 ID는 해당 속성을 유지하므로 고정된 요청에는 다른 필드가 필요하지 않습니다.
세 가지 값은 거부되며, 모두 400 오류를 반환합니다.
| 오류 | 의미 |
|---|---|
Invalid proxy format |
FourA가 발급한 ID가 아닙니다. 원시 프록시 주소를 사용하면 이 오류가 발생합니다. |
Proxy not found |
ID는 디코딩되었지만 더 이상 활성 출구로 연결되지 않습니다. 새 호출을 통해 새 ID를 받으세요. |
Managed exit: this proxy id cannot be pinned to a request |
출구는 존재하지만 FourA가 지정된 요청을 위해 열어 두는 출구가 아닙니다. 플랜에 사용할 수 있는 프리미엄 트래픽이 남아 있지 않은 경우 프리미엄 출구 ID에서 이 오류가 발생합니다. 반환된 세션을 재사용하거나 POST /api/proxy/를 통해 호출을 실행하고 자동 선택된 출구를 사용하세요. |
고정된 프리미엄 출구는 프리미엄 트래픽으로 측정됩니다. 응답에 X-FourA-Exit-Class: premium가 포함되어 요청별로 확인할 수 있으며, 사이트가 원하는 페이지를 반환했는지 여부와 관계없이 출구가 전송한 트래픽은 총 대역폭뿐만 아니라 사용량 및 한도 페이지의 프리미엄 트래픽으로 계산됩니다. 출구를 고정하려면 플랜에 프리미엄 출구가 포함되어 있고 허용량이 남아 있어야 합니다. 그렇지 않으면 위의 관리형 출구 400 오류로 ID가 거부됩니다.
HTTP 상태 코드
| 코드 | 의미 |
|---|---|
| 200 | 요청 완료 (대상 응답은 내부 status 확인) |
| 400 | 유효하지 않은 요청 본문, 파라미터, 사설/예약 대역의 대상 IP, FourA 자체 API 호스트에 속한 대상, 인코딩되지 않은 공백이 포함된 URL (Single, Proxy, Auto), 또는 고정할 수 없는 프록시 ID. Single, Proxy, Browser에서는 유효성 검사에 실패한 필드가 표시됩니다: Invalid request: <field>: <reason> (최대 5개 필드). 요금은 부과되지 않습니다. Auto는 동일한 오류에 대해 HTTP 200과 본문의 status: 400(으)로 응답합니다. |
| 401 | API 키 누락 또는 유효하지 않음 |
| 403 | 해당 엔드포인트 또는 파라미터가 사용 중인 플랜에 포함되지 않았습니다. X-FourA-Limit에 표시됩니다: plan_limit_feature 또는 plan_limit_premium. |
| 404 | Not Found: 해당 경로에 엔드포인트가 없습니다. |
| 413 | JSON 요청 본문이 100KB를 초과했습니다. 응답은 JSON 형식이 아니며 X-FourA-Request-Id을(를) 포함하지 않습니다. |
| 429 | 플랜 제한 (X-FourA-Limit 설정됨) 또는 플랫폼 공유 분당 한도 초과 (헤더 없음) |
| 500 | 내부 서버 오류 |
| 502 | Upstream unavailable: FourA가 엔진에 연결할 수 없습니다. Malformed JSON from backend: 엔진이 응답했으나 FourA가 응답을 읽을 수 없습니다. 다시 시도하십시오. |
| 503 | 서비스가 일시적으로 비활성화되었거나 용량이 초과되었습니다. FourA가 잠시 동안 키를 확인할 수 없을 때는 API key check temporarily unavailable(이)가 반환되며 (Retry-After 이후 다시 시도), 엔진 재시작 중에는 Backend service unavailable(이)가 반환됩니다. Browser에서는 모든 브라우저가 사용 중일 때 페이지가 사용 가능한 브라우저를 최대 10초간 대기하며, 시간 내에 확보되지 않으면 Backend service unavailable을(를) 받습니다. |
| 504 | Upstream timeout. 엔진이 이 요청에 할당된 제한 시간 내에 완료하지 못했습니다. timeout_ms을(를) 늘리거나 다시 시도하십시오. |
다음 단계
- 스마트 가져오기 (Auto): FourA가 경로를 직접 선택하도록 설정하는 시점
- 올바른 엔드포인트 선택: Single, Proxy, Browser를 직접 선택하는 시점
- 인증: API 키 관리
- 오류 처리: 안정적인 오류 처리 방법
- 사이트 검사:
defense필드 확인 및 통과 재생 - 프록시 요청 재시도 횟수가 소진된 이유:
attemptReport확인 및 조치 방법 - 속도 제한: 요청 제한 이해하기
- 빠른 시작: 30초 만에 첫 요청 완료하기