문서 › Dashboard › 플레이그라운드

플레이그라운드

Playground(사이드바 > Playground)를 사용하면 코드를 작성하지 않고도 실제 키로 실시간 API request를 실행할 수 있습니다. 새로운 대상 사이트를 테스트하거나, 까다로운 response를 디버깅하거나, Auto, Single, Proxy, Browser를 나란히 비교할 수 있는 가장 빠른 방법입니다.

foura.ai/dashboard#playground에서 열 수 있습니다.

기능 소개

하나의 폼. 4개의 엔진. 실제 트래픽.

  • Auto: 스마트 fetch. URL과 validate 규칙을 전달하면 FourA가 작동 가능한 가장 저렴한 경로를 선택합니다.
  • Single: 실제 브라우저와 유사한 유선 특성을 갖춘 직접 HTTP fetch
  • Proxy: 관리형 로테이팅 proxy fetch, 대상에 표시되는 국가를 선택적으로 지정 가능
  • Browser: JS 렌더링 사이트를 위해 Chrome 브라우저 인스턴스에서 URL을 엽니다.

request는 페이지 상단에서 선택한 API key를 기준으로 실행됩니다. 프로덕션 호출과 동일하게 해당 키의 quota에서 사용량이 차감되므로 테스트 중 플랜을 과도하게 소진하지 않도록 주의하십시오.

키 선택하기

API key 드롭다운에는 사용할 수 있는 모든 활성 키가 나열됩니다. My Keys 아래의 자체 키와 소속된 조직별 그룹이 표시됩니다. 모든 구성원이 조직의 키를 실행할 수 있으며, 해당 키의 request는 조직 소유자의 플랜에서 차감됩니다. request를 청구할 키를 선택하십시오. 활성 키가 아직 없는 경우 인라인 프롬프트가 키를 생성할 수 있는 API Keys 페이지로 연결해 줍니다.

모드 선택하기

상단의 Mode 행에서 Auto와 수동 엔진 간을 전환합니다. Auto를 선택하면 폼이 최소한의 Auto 인터페이스(URL, validate 및 몇 가지 설정)로 전환됩니다. 두 행이 항상 표시됩니다: Mode: Auto 및 Product: Single, Proxy, Browser. 하나를 선택하면 다른 항목의 선택이 해제됩니다. 제품을 전환하면 표시되는 필드와 request가 전송되는 엔진이 바뀝니다. 현재 선택 상태는 페이지를 새로고침해도 유지됩니다.

Mode 사용 시점
Auto 새로운 대상 또는 복합 보호가 적용된 사이트. Auto는 가장 저렴한 경로를 선택하고 작동하는 방식을 기억합니다.
Single 빠른 HTTP fetch. 알려진 호스트에 가장 적합한 첫 번째 선택지입니다.
Proxy 자동 proxy 로테이션이 적용된 동일한 fetch. 대상에 표시되는 국가가 필요한 경우 exitCountries을 설정하십시오.
Browser Chrome 브라우저 인스턴스에서 페이지를 로드합니다. JavaScript 실행 후에만 데이터가 나타나는 경우 사용하십시오.

Request 구성하기

URL 행

상단 행에는 HTTP method(GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), 대상 URL 및 Send 버튼이 있습니다. Single, Proxy, Auto는 모든 method를 지원합니다. Browser는 method(Chrome은 탐색 시 항상 GET을 전송함)와 body를 무시합니다.

Request 탭

URL 행 아래의 5개 탭에서 나머지 항목들을 채울 수 있습니다:

탭 제어 항목
UI timeouts, redirects, flags, proxy, 브라우저 전용 옵션 및 validate 규칙용 폼 필드
Body POST / PUT / PATCH request를 위한 자유 형식 본문
Headers 키-값 쌍 형태의 커스텀 request headers
Cookies request와 함께 전송할 cookies
Raw 전송될 정확한 JSON payload를 읽기 전용 미리보기로 제공하며 Copy JSON 및 하단 cURL 재현 명령어 포함

UI / Body / Headers / Cookies에서 변경한 모든 내용은 Raw에 즉시 반영됩니다. Raw에는 직접 입력할 수 없으며 다른 탭에서 request를 수정해야 합니다. 엔진 기본값과 다른 값을 포함하는 탭이나 접을 수 있는 섹션에는 빨간색 점이 표시되므로 맞춤 설정한 항목을 한눈에 확인할 수 있습니다.

UI 패널 섹션

UI 탭은 설정을 접을 수 있는 섹션으로 그룹화합니다. 빈 필드는 엔진의 스키마 기본값으로 대체됩니다. 현재 Mode에 적용되지 않는 섹션은 숨겨집니다.

  • Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec. Auto 모드는 timeout_ms(총 예산)만 노출합니다.
  • Redirects: 토글 및 followRedirects 설정 (0-20). Single 및 Proxy 전용. Browser 모드는 자체적으로 리디렉션을 따릅니다.
  • Flags: Single, Proxy 및 Browser용 unblocker (Browser에서 unblocker는 페이지가 요구하는 검사를 완료함), Single 및 Proxy용 tryJsonData 및 returnBuffer. Auto는 대신 forceProxy 및 returnSession를 노출합니다.
  • Proxy: Single 또는 Browser용 특정 프록시 ID를 선택하거나, Proxy 엔진용 maxTries, Proxy 외부 timeout, exitCountries, exitClass, ignoreProxies를 설정합니다. Auto는 ignoreProxies도 노출합니다. exitClass 선택 메뉴에는 세 가지 상태가 있습니다. 설정 해제 시 필드를 전혀 전송하지 않고, standard는 request를 절대 에스컬레이션하지 않도록 지정하며, premium는 표준 풀에 문제가 발생할 때 프리미엄 출구로 에스컬레이션되도록 허용합니다. 설정 해제와 standard는 서로 다른 request이므로 둘 중 하나를 의도하지 않았다면 선택 메뉴를 비워 두세요. 프리미엄을 사용하려면 프리미엄 출구가 포함된 플랜이 필요합니다. 자세한 내용은 exitClass를 참조하세요.
  • Browser profile: FourA가 실제로 렌더링할 수 있는 항목을 나열하는 세 개의 연계 드롭다운(os, browser, version). Single 및 Proxy 모드에서 표시됩니다. 최신 Chrome을 사용하려면 비워 두세요. 각 선택 항목은 다른 두 항목의 범위를 좁히므로 유효하지 않은 조합은 나타나지 않습니다. 이 섹션은 unblocker가 켜져 있어야 합니다. 꺼져 있으면 브라우저 header가 전송되지 않아 프로필이 절반만 적용되며 API가 request를 거부합니다.
  • Browser: checkStatus 및 checkText와 같은 브라우저 전용 옵션.
  • Validate: status accept 및 status fail은 쉼표로 구분된 상태 코드(validate.status)를 받고, body accept 및 body fail은 |로 구분된 대체 부분 문자열(validate.data)을 받습니다. Single, Proxy 및 Auto에서 사용할 수 있습니다. Browser는 대신 checkStatus 및 checkText를 사용합니다. 폼에는 header 규칙(validate.headers)을 위한 필드가 없습니다.

실행을 통해 작동하는 proxy가 반환되면 UI 탭 하단에 Working proxies 섹션이 표시됩니다. 최신순으로 최대 20개의 proxy ID가 나열되며, 각각의 출구 국가와 시간이 함께 제공됩니다. use를 클릭하면 Single 또는 Browser의 proxy 필드에 해당 proxy가 입력되고(Proxy 엔진은 자체 검색), **×**를 누르면 목록에서 삭제됩니다.

Exit Country Scoping (Proxy Mode)

Proxy의 exitCountries 필드는 쉼표로 구분된 2자리 타겟 표시 국가 코드 목록(CZ, GB)을 허용합니다. 입력값은 제출 시 공백 제거, 대문자 변환, 중복 제거가 수행됩니다. 선택은 엄격한 허용 목록(allowlist) 방식을 따릅니다. 출구를 알 수 없는 proxy는 제외되며, 요청이 다른 국가로 절대 대체(fallback)되지 않습니다. 현재 풀에 일치하는 항목이 없으면 응답은 요청된 범위를 details.exitCountries에 그대로 반영하여 code: "no_eligible_proxy"를 반환합니다. 범위를 유지하고 나중에 다시 시도하십시오.

범위 지정 하에서 proxy 호출이 성공하면, 제공된 국가가 요청한 국가와 일치하는지 확인할 수 있도록 응답 스트립의 proxy ID 옆에 exit <CODE>가 표시됩니다.

Toolbar Reset

툴바의 Reset 버튼(History 및 Saved 옆)은 플레이그라운드를 초기 상태로 지웁니다. 이는 파괴적인 작업이므로 삭제될 항목 목록을 명시하는 확인 대화상자가 열립니다. 3가지 제품 폼(Single, Proxy, Browser), jar에 저장된 모든 cookie, 연결된 모든 proxy, 현재 응답이 모두 삭제됩니다. 저장된 프리셋과 선택된 API key는 유지됩니다. 확인하려면 Reset everything을 클릭하고, 그 외의 동작은 취소됩니다.

Sending and Canceling

요청을 보내려면 Send를 클릭합니다. 호출이 진행되는 동안 오른쪽 열은 스피너와 Cancel 버튼이 있는 로딩 상태로 전환됩니다. 중단하려면 Cancel을 클릭(또는 모바일에서 버튼을 다시 탭)합니다. 취소된 요청은 오류를 표시하는 대신 "Request canceled."라는 유휴 플레이스홀더를 복원합니다.

요청이 완료되거나 실패하는 즉시 응답 카드가 결과 화면으로 전환됩니다. Auto 실행은 콜드 타겟에서 여러 단계를 거칠 수 있으므로 수동 엔진보다 오래 걸릴 수 있습니다.

Reading the Response

응답 열은 고유한 탭 구성을 통해 요청 레이아웃을 그대로 반영합니다.

Tab What it shows
Body 파싱된 본문. 반환된 내용에 따라 JSON, HTML, Text 뷰 간에 전환됩니다.
Headers 응답 header 목록(한 줄에 하나씩 표시).
Cookies 대상에서 반환한 cookie 목록(파싱된 뷰(호스트별 그룹화) 및 원시 뷰(Set-Cookie 텍스트) 모두 제공). 파싱된 뷰에서는 host-only cookie에 HO 배지가 표시되며, domain cookie에는 표시되지 않습니다.
Raw API가 반환한 전체 JSON 엔벨로프.

응답 툴바에는 전체 응답에 대한 Copy 및 Download 기능과 열려 있는 탭을 검색할 수 있는 Find in response(Ctrl+K 또는 Cmd+K) 기능이 있으며, Enter 및 Shift+Enter로 일치 항목 간을 이동할 수 있습니다. Body, Headers, Cookies 탭에도 해당 탭만을 위한 Copy 및 Download 버튼이 별도로 제공됩니다.

탭 상단의 메타 스트립에는 업스트림 HTTP 상태, 총 소요 시간, 호출을 처리한 proxy ID 및 (범위가 지정된 Proxy 호출의 경우) 두 자리 exit <CODE> 코드가 표시됩니다. Auto 실행의 경우 스트립에 응답을 전달한 래더 단계, 수행된 하위 시도 횟수, 사용된 크레딧도 함께 표시됩니다.

호출 처리에 필요했던 항목

메타 스트립 아래의 문구는 페이지를 가져오는 데 사용된 수단을 텍스트로 설명합니다. Auto 실행의 경우 사용된 단계(FourA가 호스트에 대해 이미 보유한 세션, 일반 request, 교체되는 proxy, 실제 브라우저, 브라우저 우선 실행 후 저렴한 재생 등), 챌린지 해결 여부, 시도 횟수 및 발생한 비용을 명시합니다.

플랜 한도로 인해 호출이 거부된 경우 문구에 "Stopped by your plan, not by the site"라는 내용이 먼저 표시되며, 이어서 어떤 한도(오늘의 브라우저 request 소진, 처리 중인 request 초과, 이번 기간의 크레딧 소진 등)인지와 함께 Usage & Limits 링크가 제공됩니다. 이 라인은 API가 반환한 X-FourA-Limit 코드를 기반으로 생성되므로, 처리가 까다로운 페이지에서 실패가 발생했을 때 사이트가 차단한 것인지 플랜에 의해 중단된 것인지 확인할 수 있습니다.

실행 간 값 전달(Carry)

재사용 가능한 세션 데이터를 반환한 실행이 끝나면, 응답 툴바의 작은 Carry 컨트롤에 사용 가능한 항목이 표시됩니다.

  • Auto 실행은 완전한 session 3종 세트(proxy, cookies, userAgent)를 제공합니다.
  • Browser 실행은 응답 userAgent 및 사용된 경우 proxy ID를 제공합니다.
  • Proxy 실행은 반환된 proxy ID, 로테이션 중 요청하지 않은 항목이 선택되었을 때의 브라우저 프로필, 호출을 처리한 exitClass를 제공하여 프리미엄 응답을 바로 다시 전송할 수 있도록 합니다.

Carry를 클릭하고 한 번의 클릭으로 각 값을 적용할 위치를 선택할 수 있습니다. userAgent은 Single 또는 Proxy의 User-Agent header가 되고, proxy ID는 Single 또는 Browser의 proxy 필드에 입력됩니다. 전달된 값을 받은 필드에는 변경 사항을 확인할 수 있도록 "수정됨" 빨간색 점이 표시됩니다.

전달된 브라우저 프로필은 os, browser, version의 세 가지 선택 항목을 채우고 unblocker을 활성화합니다. 이는 프로필을 수동으로 선택할 때와 동일한 규칙입니다. 폼이 id 필드가 아닌 세 개의 선택 항목으로 구성되어 있으므로 프로필 카탈로그가 로드된 후에만 제공됩니다.

프로필은 성공한 request가 사용자가 입력했던 request와 다르다는 것을 알려주는 유일한 값입니다. Proxy는 요청하지 않은 브라우저 제품군으로 변경된 경우에만 profile을 보고합니다. 이 값 없이 재생하면 실패했던 버전을 다시 실행하게 됩니다. Why a Proxy Request Ran Out of Tries를 참조하십시오.

전체 화면으로 확장

응답 툴바의 확장 아이콘을 누르면 응답 카드가 분할 레이아웃에서 벗어나 전체 화면 오버레이로 전환됩니다. 계층이 깊은 JSON 트리, 긴 Set-Cookie 덤프, 너비가 좁아 보기 불편한 넓은 HTML body를 확인할 때 사용하십시오. 오버레이가 열려 있는 동안 페이지 자체의 스크롤은 중지됩니다. 아이콘을 다시 클릭하거나 Escape 키를 누르면 축소됩니다.

curl 재현 도구

request의 Raw 탭 아래 JSON 밑에는 작성 중인 request와 정확히 일치하는 명령줄 cURL 블록과 Copy curl 버튼이 표시됩니다. 이를 복사하여 터미널에서 request를 재현하거나, 팀원과 공유하거나, 버그 리포트에 붙여넣을 수 있습니다.

표시 가능한 키의 경우, 스니펫 옆의 Reveal key 버튼을 누르면 실제 일반 텍스트 키가 cURL에 바로 입력되어 그대로 복사해 실행할 수 있습니다. 다시 클릭하면 숨겨집니다. 표시 기능이 출시되기 전에 생성된 레거시 키는 PASTE_PLAINTEXT_FOR_<key-name> 플레이스홀더를 유지합니다. 이를 표시 가능하게 하려면 API Keys 페이지에서 키를 재생성하십시오.

키 표시는 매번 서버에 감사 로그로 기록되며, 일반 텍스트 키는 현재 페이지 세션의 메모리에만 유지됩니다.

프리셋 저장

동일한 대상을 반복해서 재구성해야 한다면 이를 저장하십시오. request 탭 행에서 Save를 클릭하여 현재 구성을 이름이 지정된 프리셋으로 저장할 수 있습니다.

도구 모음에서 Saved를 열어 프리셋을 확인하십시오. 폼을 채우려면 Load를, 프리셋을 제거하려면 Delete를 클릭하십시오.

FourA Chrome 확장의 DevTools 탭에서 연 request는 해당 키가 계정에 있을 때 확장의 키가 선택된 상태로 로드되며, 페이지에 해당 내용이 표시됩니다. 그렇지 않은 경우 키를 선택하라는 메시지가 표시됩니다. unblocker를 설정하지 않은 재생된 request는 API와 마찬가지로 해당 기능을 켠 상태로 실행됩니다.

프리셋 필드 저장 항목
Name 짧은 라벨 (최대 100자)
Description 선택적 메모 (최대 500자)
Endpoint 프리셋이 대상하는 엔진 (auto / single / proxy / browser)
Config UI 필드, header, cookie, body를 포함한 전체 request 페이로드

프리셋은 사용자 계정으로 범위가 지정되며 팀원과 공유되지 않습니다.

히스토리에서 재생

실행하는 모든 request는 기록됩니다. 도구 모음에서 History를 열어 최신순으로 정렬된 최근 20개의 실행 기록을 확인하십시오.

각 행에는 endpoint, 대상 URL, 상태, 시간이 표시됩니다. 아무 행에서나 Replay를 클릭하여 해당 request를 폼에 다시 로드한 다음 Send를 클릭하여 다시 실행하십시오.

히스토리는 계정별로 자동 적용되므로 본인이 실행한 내역만 볼 수 있습니다.

Activity에서 열기

Activity Log 상세 대화상자에는 Open in Playground 버튼이 있습니다. 이를 클릭하면 Playground가 아카이브된 request 및 response와 함께 로드됩니다. 폼은 저장된 페이로드로 채워지며, response 카드에는 proxy 메타 스트립에 "archived" 배지("archived

여기서 파라미터를 변경하고 Send를 눌러 라이브 API에 대해 새 request를 실행하거나, 다시 실행하지 않고 아카이브된 페이로드를 검사할 수 있습니다. 페이로드는 24시간 동안 보관되므로 오래된 Activity 행에는 다시 로드할 수 있는 response가 없습니다.

팁

  • 새 대상을 상대로 코드를 작성하기 전에 Playground에서 먼저 시작하세요. Auto를 켜면 비용이 적게 드는 일반 fetch로 충분한지, 사이트에서 브라우저 렌더링을 요구하는지 몇 초 만에 파악할 수 있습니다.
  • 국가 제한이 있는 대상의 경우 exitCountries 설정을 적용해 Proxy 호출을 한 번 실행한 다음, 반환된 proxy ID를 Browser 호출로 전달하여 동일한 출구를 통해 JavaScript 렌더링이 이루어지도록 하세요.
  • 정기적으로 스크래핑하는 모든 대상에 대해 프리셋을 저장하세요. 저장된 프리셋은 클릭 한 번으로 다시 실행할 수 있지만, 기억에 의존해 요청을 다시 구성하는 데는 더 오랜 시간이 걸립니다.
  • 세션 기반 스크래핑을 디버깅할 때는 Cookies 탭을 사용하세요. 원본 Set-Cookie 뷰는 대상이 전송한 내용을 정확히 보여줍니다.
  • 대상이 요청을 거부하는 경우 더 무거운 엔진을 적용하기 전에 Browser 프로필 선택 항목에서 다른 항목을 사용해 보세요. 브라우저 정보를 변경하는 것은 무료이지만, 브라우저 렌더링은 그렇지 않습니다.
  • Playground 요청은 선택한 키에 비용이 청구됩니다. 프로덕션 사용량을 깔끔하게 유지하려면 단순 테스트용으로 할당량이 적은 전용 키를 사용하세요.
최근 업데이트: 2026년 9월 30일
← 계정 설정 Proxy 사용자 →