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

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

기능

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

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

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

키 선택

API key 드롭다운에는 사용할 수 있는 모든 활성 키가 나열됩니다. My Keys 아래의 개인 키와 소속된 각 조직별 그룹 키가 표시됩니다. 모든 멤버는 조직의 키를 실행할 수 있으며 해당 키의 요청은 조직 소유자의 플랜에서 차감됩니다. 요청 비용을 청구할 키를 선택하십시오. 아직 활성 키가 없다면 인라인 안내 메시지가 API Keys 페이지로 연결되어 키를 생성할 수 있도록 지원합니다.

모드 선택

상단의 Mode 행에서 Auto와 수동 엔진 간을 전환할 수 있습니다. Auto를 선택하면 폼이 최소한의 Auto 인터페이스(URL, validate 및 몇 가지 설정)로 전환됩니다. Mode: Auto, 그리고 Endpoint: Single, Proxy, Browser의 두 행이 항상 표시됩니다. 하나를 선택하면 다른 항목은 선택 해제됩니다. endpoint를 전환하면 표시되는 필드와 요청이 도달하는 엔진이 변경됩니다. 페이지를 새로고침해도 현재 선택 상태는 유지됩니다.

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

요청 구성

URL 행

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

요청 탭

URL 행 아래의 5개 탭을 통해 나머지 모든 항목을 입력할 수 있습니다.

탭 제어 대상
UI 타임아웃, 리디렉션, 플래그, proxy, 브라우저 전용 옵션 및 검증 규칙에 대한 폼 필드
Body POST / PUT / PATCH request를 위한 자유 형식 본문
Headers 키-값 쌍 형태의 커스텀 request header
Cookies 이 브라우저의 호스트별로 유지되는 cookie jar. Use jar는 일치하는 cookie를 request에 첨부하고, Save response cookies는 response가 설정한 cookie를 저장합니다. 둘 다 기본적으로 활성화되어 있으며, 탭에서 이 request가 전송할 내용을 미리 볼 수 있습니다
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. Browser 및 Auto는 timeout_ms만 노출합니다 (Auto의 경우 전체 예산).
  • Redirects: 토글 및 followRedirects 설정 (0-20). Single 및 Proxy. Browser는 자체적으로 리디렉션을 따릅니다.
  • Flags: Single, Proxy, Browser용 unblocker (Browser의 unblocker는 페이지가 요청하는 확인 절차를 완료함), Single 및 Proxy용 tryJsonData 및 returnBuffer. Auto는 대신 forceProxy 및 returnSession를 노출합니다.
  • Proxy: Single 또는 Browser용 특정 proxy ID를 선택하거나, Proxy 엔진을 위해 maxTries, Proxy 외부 timeout, exitCountries, exitClass, ignoreProxies를 설정합니다. Auto는 ignoreProxies 및 exitClass도 노출합니다. exitClass 선택 항목에는 세 가지 상태가 있습니다. 설정 해제는 필드를 전혀 전송하지 않고, standard는 표준 풀을 지정하며, premium는 표준 풀 처리가 지연될 때 요청을 프리미엄 exit로 승격하도록 허용합니다. 설정 해제와 standard는 모두 표준 풀을 유지합니다. 클래스를 지정한 성공적인 요청은 exitClass를 반환받습니다. 프리미엄을 사용하려면 프리미엄 exit가 포함된 플랜이 필요합니다. exitClass를 참고하십시오.
  • Browser profile: FourA가 실제로 제공할 수 있는 항목을 나열하는 세 개의 계단식 드롭다운 os, browser, version입니다. Single 및 Proxy 모드에서 나타납니다. 최신 Chrome을 사용하려면 비워 두십시오. 각 선택 항목은 다른 두 항목의 범위를 좁히므로 유효하지 않은 조합은 절대 나타나지 않습니다. 이 섹션은 unblocker가 켜져 있어야 합니다. 꺼져 있으면 브라우저 header가 전송되지 않아 프로필이 절반만 적용되며, API는 요청을 거부합니다.
  • 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가 각 exit 국가 및 시간과 함께 나열됩니다. use를 누르면 Single 또는 Browser의 proxy 필드에 입력되며 (Proxy 엔진은 자체 검색), **×**를 누르면 목록에서 제거됩니다.

Exit 국가 범위 지정 (Proxy 모드)

Proxy의 exitCountries 필드는 쉼표로 구분된 두 자리 대상 표시 국가 코드 목록(CZ, GB)을 허용합니다. 제출 시 값의 공백이 제거되고 대문자로 변환되며 중복이 제거됩니다. 표준 풀에서의 선택은 엄격한 허용 목록 방식입니다. 알 수 없는 출구의 프록시는 제외되며 풀은 다른 국가로 절대 대체되지 않습니다. 프리미엄 출구도 이 목록을 따릅니다. exitClass가 premium로 설정되면 프리미엄 출구는 나열된 국가 중 하나에서 나가며, 표준 풀에 리소스가 없는 국가는 해당 위치의 프리미엄 출구로 라우팅됩니다. premium가 없으면 일치하는 항목이 없는 풀은 details.exitCountries에 요청된 범위를 에코하여 code: "no_eligible_proxy"을 반환합니다. 범위를 유지하고 나중에 다시 시도하십시오.

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

출구 위치 (Proxy 모드)

Proxy의 Exit location 그룹은 프리미엄 출구가 나갈 위치를 선택합니다: 지역, 도시, 네트워크, 디바이스 및 주소 유지 기간. exitCountries에 정확히 하나의 국가만 지정되면 지역, 도시 및 네트워크 목록이 채워집니다. 이 중 어느 것을 선택해도 요청이 프리미엄 출구로만 전송되므로 exitClass를 premium로 설정하십시오. 응답의 프록시 ID가 위치를 유지하므로 이를 Single 또는 Browser로 가져가기만 하면 됩니다. 출구 위치를 참조하십시오.

툴바 재설정

툴바의 Reset 버튼(History 및 Saved 옆)은 플레이그라운드를 초기 상태로 지웁니다. 파괴적인 작업이므로 삭제될 항목을 정확히 나열하는 확인 대화상자가 열립니다: 모든 요청 탭, jar에 저장된 모든 쿠키, 전달된 모든 프록시 및 현재 응답. 저장된 프리셋과 선택한 API 키는 유지됩니다. 확인하려면 Reset everything을 클릭하십시오. 다른 동작은 취소됩니다.

전송 및 취소

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

요청이 완료(또는 실패)되는 즉시 응답 카드가 결과로 전환됩니다. 휴대폰 화면이나 폼 아래에 응답이 배치될 만큼 좁은 창에서는 응답 카드가 화면 하단에 도착할 때 페이지가 이를 뷰포트로 가져옵니다. Auto 실행은 콜드 타깃에서 사다리 단계가 여러 번 올라갈 수 있으므로 수동 엔진보다 오래 걸릴 수 있습니다.

응답 확인

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

탭 표시 내용
Body 파싱된 본문입니다. 반환된 내용에 따라 JSON, HTML, Text 뷰 간에 전환됩니다.
Headers 라인당 하나씩 표시되는 응답 헤더입니다.
Cookies 대상이 반환한 쿠키로, 파싱된 뷰(호스트별 그룹화)와 원시 뷰(Set-Cookie 텍스트) 모두 제공됩니다. 파싱된 뷰에서는 호스트 전용 쿠키에 HO 배지가 표시되며, 도메인 쿠키에는 표시되지 않습니다.
Raw API가 반환한 전체 JSON 엔벨로프입니다.

응답 툴바에는 전체 응답에 대한 복사 및 다운로드 기능과 열려 있는 탭을 검색할 수 있는 응답에서 찾기(Ctrl+K 또는 Cmd+K)가 제공되며, Enter 및 Shift+Enter를 사용하여 일치 항목 간을 이동할 수 있습니다. Body, Headers, Cookies 탭에도 해당 탭 전용 복사 및 다운로드 기능이 있습니다.

탭 위의 메타 스트립에는 업스트림 HTTP 상태, 총 소요 시간, 호출을 처리한 프록시 ID 및 범위가 지정된 프록시 호출의 경우 두 자리 exit <CODE>가 표시됩니다. 또한 이 스트립에는 응답 크기와 API가 보고한 경우 요청에 사용된 크레딧이 표시됩니다. Auto 실행의 경우 단계(rung) 및 시도 횟수가 스트립 아래 문장에 표시됩니다.

호출 처리에 사용된 리소스

메타 스트립 아래 문장은 페이지를 처리한 수단을 텍스트로 설명합니다. Auto 실행의 경우 단계(FourA가 해당 호스트에 대해 이미 보유한 세션, 일반 요청, 순환 프록시, 실제 브라우저, 브라우저 선행 실행 후 저렴한 재생 등), 챌린지 해결 여부, 시도 횟수 및 비용을 명시합니다. 요청에 exitClass가 설정된 경우 프리미엄 출구 풀 또는 표준 풀 중 어느 것을 통해 전달되었는지도 표시합니다.

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

실행 간 값 전달

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

  • returnSession 옵션으로 수행된 Auto 실행은 세션의 userAgent 및 proxy를 제공합니다. 세션 쿠키는 응답의 Cookies 탭에 표시되며, Save response cookies가 켜져 있으면 쿠키 저장소에 저장됩니다.
  • Browser 실행은 응답 userAgent와 함께 프록시가 사용된 경우 해당 프록시 ID를 제공합니다.
  • Proxy 실행은 반환된 프록시 ID를 제공하며, 순환을 통해 명시적으로 요청하지 않은 브라우저 프로필이 선택된 경우 해당 프로필도 제공합니다.

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

전달된 browser profile은 OS, browser, version 세 가지 선택 항목을 채우고 unblocker 옵션을 켭니다. 프로필을 직접 선택할 때 적용되는 규칙과 동일합니다. 양식이 ID 필드가 아닌 세 개의 선택 항목으로 구성되어 있으므로, 프로필 카탈로그가 로드된 후에만 제공됩니다.

프로필은 성공한 request가 사용자가 입력한 request와 다르다는 점을 나타내는 유일한 값입니다. Proxy는 요청하지 않은 브라우저 제품군으로 변경된 경우에만 profile 상태를 보고합니다. 이 값 없이 다시 실행하면 실패했던 버전을 다시 실행하게 됩니다. Proxy Request 시도 횟수가 소진된 이유를 참고하십시오.

전체 화면으로 확장

response 툴바의 확장 아이콘을 클릭하면 분할 레이아웃에서 response 카드가 분리되어 전체 화면 오버레이로 전환됩니다. 계층이 깊은 JSON 트리, 긴 Set-Cookie 덤프, 또는 반쪽 너비 열에서 보기 비좁은 넓은 HTML 본문을 확인할 때 사용하십시오. 오버레이가 열려 있는 동안에는 페이지 자체의 스크롤이 중지됩니다. 축소하려면 아이콘을 다시 클릭하거나 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 페이로드

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

History에서 다시 실행

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

각 행에는 endpoint, 대상 URL, 상태 및 시간이 표시됩니다. 특정 행에서 Replay를 클릭하면 해당 request를 폼으로 다시 불러오며, 이후 Send를 클릭하여 다시 실행할 수 있습니다.

히스토리는 계정 단위로 자동 제한되므로 본인이 실행한 내역만 확인할 수 있습니다.

Activity에서 열기

Activity Log 상세 다이얼로그에는 Open in Playground 버튼이 있습니다. 이를 클릭하면 아카이브된 request와 response가 함께 로드된 상태로 Playground가 열립니다. 저장된 payload를 바탕으로 폼이 채워지며, response 카드에는 당시 API가 반환한 내용이 proxy 메타 스트립의 "archived" 배지와 함께 표시됩니다("archived

여기서 매개변수를 수정한 뒤 Send를 클릭해 라이브 API를 대상으로 새 request를 실행하거나, 다시 실행하지 않고 아카이브된 payload만 검사할 수 있습니다. Payload는 24시간 동안 보관되므로 오래된 Activity 행에는 다시 불러올 수 있는 response가 없습니다.

팁

  • 새로운 타깃을 대상으로 코드를 작성하기 전에 Playground에서 먼저 시작하십시오. Auto를 활성화하면 비용이 적게 드는 fetch만으로 충분한지, 아니면 사이트에서 브라우저 렌더링을 강제하는지 몇 초 만에 확인할 수 있습니다.
  • 국가 제한이 걸린 대상의 경우 exitCountries를 설정한 상태로 Proxy 호출을 한 번 실행한 뒤, 반환된 proxy ID를 Browser 호출로 전달하여 동일한 출구를 통해 JavaScript 렌더링이 이루어지도록 하십시오.
  • 주기적으로 스크래핑하는 모든 대상에 대해 프리셋을 저장하십시오. 저장된 프리셋을 재생하는 작업은 클릭 한 번이면 충분하지만, 기억에 의존해 request를 다시 구성하는 작업은 더 많은 시간이 소요됩니다.
  • 세션 기반 스크래핑을 디버깅할 때는 Cookies 탭을 사용하십시오. 원시 Set-Cookie 뷰에 대상이 전송한 내용이 그대로 표시됩니다.
  • 대상이 요청을 거부할 경우 더 무거운 엔진으로 전환하기 전에 Browser profile 선택 항목에서 다른 프로필을 먼저 시도해 보십시오. 표출되는 브라우저를 변경하는 것은 무료이지만, 브라우저 렌더링은 비용이 발생합니다.
  • Playground request는 사용자가 선택한 키를 기준으로 과금됩니다. 프로덕션 사용량을 깔끔하게 유지하려면 단순 테스트용으로 쿼터가 적은 전용 키를 사용하십시오.
최근 업데이트: 2026년 11월 11일