문서 › Dashboard › Playground

Playground

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

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

What It Does

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

  • Single: 실제 브라우저와 유사한 네트워크 특성을 가진 직접 HTTP fetch
  • Proxy: 관리형 순환 proxy fetch
  • Browser: JS 렌더링 사이트를 위해 Chrome 브라우저 인스턴스에서 URL을 엽니다

Request는 페이지 상단에서 선택한 API key를 기준으로 실행됩니다. 사용량은 프로덕션 호출과 동일하게 해당 키의 할당량에서 차감되므로, 테스트 중에 요금제 사용량을 모두 소모하지 않도록 주의하세요.

Picking a Key

API key 드롭다운에는 개인 키, 관리 중인 조직 키, 액세스 가능한 팀 공유 키 등 귀하의 범위 내에 있는 모든 활성 키가 표시됩니다. Request 비용을 청구할 키를 선택하세요. 아직 활성화된 키가 없는 경우, 인라인 안내를 통해 API Keys 페이지로 이동하여 키를 생성할 수 있습니다.

Choosing a Product

폼 위에는 Single, Proxy, Browser라는 세 개의 필(pill) 버튼이 있습니다. 버튼을 전환하면 표시되는 필드와 request가 도달하는 엔진이 변경됩니다. 페이지를 새로 고쳐도 현재 선택 사항이 유지됩니다.

Product 사용 시기
Single 빠른 HTTP fetch. 모든 URL에 대해 가장 먼저 선택하기 좋습니다.
Proxy 자동 proxy 순환이 적용된 동일한 fetch. Single이 계속 차단될 때 사용합니다.
Browser Chrome 브라우저 인스턴스에서 페이지를 로드합니다. JavaScript가 실행된 후에만 데이터가 나타날 때 사용합니다.

Building the Request

URL Row

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

Request Tabs

URL 행 아래에 있는 5개의 탭을 통해 나머지 정보를 입력할 수 있습니다.

Tab 제어 대상
UI 타임아웃, 리디렉션, 플래그, proxy, 브라우저 전용 옵션, validate 규칙을 설정하는 폼 필드
Body POST / PUT / PATCH request를 위한 자유 형식의 body
Headers 키-값 쌍 형태의 커스텀 request header
Cookies request와 함께 전송할 cookie
Raw 전송될 정확한 JSON 페이로드 (직접 편집 가능)

UI / Body / Headers / Cookies에서 변경한 모든 내용은 Raw에 반영됩니다. Raw를 직접 편집해도 다른 탭이 그에 맞게 업데이트됩니다.

UI Pane Sections

UI 탭은 설정을 접을 수 있는 섹션으로 그룹화합니다. 빈 필드는 엔진의 스키마 기본값으로 대체됩니다.

  • Timeouts: timeout_ms, connect_timeout_ms, accept_timeout_ms, server_response_timeout_ms, dns_cache_timeout_sec
  • Redirects: followRedirects (0-20)를 토글하고 설정합니다. Single 및 Proxy 전용입니다. Browser는 자체적으로 리디렉션을 따릅니다.
  • Flags: unblocker, tryJsonData, returnBuffer. Single 및 Proxy 전용입니다.
  • Proxy: Single 또는 Browser에 사용할 특정 proxy ID를 선택하거나, Proxy 엔진에 대해 maxTries, Proxy 외부 타임아웃, ignoreProxies를 설정합니다.
  • Browser: checkStatus 및 checkText와 같은 브라우저 전용 옵션입니다.
  • Validate: validate.status (상태 코드), validate.headers (header 키-값 규칙), validate.data (body 수락/실패 하위 문자열, |로 구분된 대체 값) 수락/실패 규칙입니다.

현재 선택한 제품에 적용되지 않는 필드는 숨겨집니다.

Toolbar Reset

툴바의 Reset 버튼(History 옆)을 누르면 활성화된 제품의 폼이 기본값으로 초기화됩니다. 기본값은 가장 일반적인 시작 지점에 맞춰 unblocker 및 tryJsonData가 켜져 있는 상태입니다. 작동하는 기준점에서 너무 멀어져 페이지를 새로 고치지 않고 처음부터 다시 시작하고 싶을 때 사용하세요.

Sending and Canceling

Send를 클릭하여 request를 전송합니다. 호출이 진행되는 동안 오른쪽 열은 스피너와 Cancel 버튼이 있는 로딩 상태로 전환됩니다. 취소하려면 Cancel을 클릭(또는 모바일에서 버튼을 다시 탭)하세요. 취소된 request는 에러를 표시하는 대신 대기 상태 자리 표시자를 "Request canceled."로 복원합니다.

Request가 완료(또는 실패)하는 즉시 response 카드가 결과로 전환됩니다.

Reading the Response

Response 열은 자체 탭을 통해 request 레이아웃을 미러링합니다.

Tab 표시 내용
Body 파싱된 body. 반환된 내용에 따라 JSON, HTML, Text 뷰 간에 전환됩니다.
Headers 한 줄에 하나씩 표시되는 response header.
Cookies 대상이 반환한 cookie로, 파싱된 뷰(호스트별 그룹화)와 raw 뷰(Set-Cookie 텍스트)를 모두 제공합니다. 파싱된 뷰에서는 host-only cookie에 HO 배지가 표시되며, 도메인 cookie에는 표시가 없습니다.
Raw API가 반환한 전체 JSON 봉투(envelope).

탭 위의 메타 스트립에는 업스트림 HTTP 상태, 총 소요 시간, 그리고 (Proxy 또는 proxy ID가 포함된 single request의 경우) 호출을 처리한 proxy ID가 표시됩니다. 각 패널의 우측 상단에 복사 및 다운로드 버튼이 있어 클릭 한 번으로 body나 header를 파일로 가져올 수 있습니다.

Expand to Full Screen

Response 툴바의 확대 아이콘을 누르면 response 카드가 분할 레이아웃에서 벗어나 전체 화면 오버레이로 표시됩니다. 계층이 깊은 JSON 트리, 긴 Set-Cookie 덤프 또는 가로로 넓은 HTML body로 인해 절반 너비의 열이 비좁을 때 사용하세요. 오버레이가 열려 있는 동안에는 페이지 자체의 스크롤이 중지됩니다. 아이콘을 다시 클릭(또는 Escape 키 입력)하면 축소됩니다.

The curl Reproducer

Response 아래의 curl 블록에는 방금 빌드한 request와 정확히 동일한 명령줄 코드가 표시됩니다. 터미널에서 request를 재현하거나, 팀원과 공유하거나, 버그 리포트에 붙여넣을 때 복사하여 사용하세요.

공개 가능한 키의 경우, 스니펫 옆의 Reveal key 버튼을 누르면 실제 평문 키가 curl에 바로 삽입되어 그대로 복사하여 실행할 수 있습니다. 다시 클릭하면 숨겨집니다. 레거시 키(공개 기능이 출시되기 전에 생성된 키)는 PASTE_PLAINTEXT_FOR_<key-name> 자리 표시자를 유지하므로, 공개 가능하게 만들려면 API Keys 페이지에서 키를 재생성하세요.

키 공개는 매번 서버에 감사 로그(audit log)로 기록되며, 평문 키는 현재 페이지 세션의 메모리에만 유지됩니다.

Saving Presets

동일한 대상을 반복해서 재설정해야 하는 경우, 이를 저장해 두세요. Request 탭 행에서 Save를 클릭하면 현재 설정을 이름이 지정된 프리셋으로 저장할 수 있습니다.

툴바에서 Saved를 열어 프리셋을 탐색, 이름 변경 또는 삭제할 수 있습니다. 프리셋을 클릭하면 해당 설정이 폼에 다시 로드됩니다.

Preset 필드 저장 내용
Name 짧은 레이블 (최대 100자)
Description 선택 사항 메모 (최대 500자)
Endpoint 프리셋이 적용되는 제품 (single / proxy / browser)
Config UI 필드, header, cookie, body를 포함한 전체 request 페이로드

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

Replaying from History

실행하는 모든 request는 로그에 기록됩니다. 툴바에서 History를 열면 가장 최근에 실행한 20개의 기록을 최신순으로 볼 수 있습니다.

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

History is 자동으로 귀하의 계정으로 제한되므로 본인이 실행한 기록만 볼 수 있습니다.

Opening from Activity

Activity Log 상세 대화 상자에는 Open in Playground 버튼이 있습니다. 이 버튼을 클릭하면 아카이브된 request와 response가 모두 포함된 상태로 Playground가 로드됩니다. 저장된 페이로드로 폼이 채워지고, response 카드에는 당시 API가 반환한 내용이 proxy 메타 스트립의 "archived" 배지("archived

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

Tips

  • 새로운 대상을 상대로 코드를 작성하기 전에 Playground에서 먼저 시작하세요. Single로 충분한지 아니면 Browser가 필요한지 몇 초 안에 파악할 수 있습니다.
  • 정기적으로 스크래핑하는 모든 대상에 대해 프리셋을 저장해 두세요. 저장된 프리셋을 재실행하는 것은 클릭 한 번이면 되지만, 기억에 의존해 request를 다시 구성하는 것은 더 오래 걸립니다.
  • 세션 기반 스크래핑을 디버깅하려면 Cookies 탭을 사용하세요. raw Set-Cookie 뷰를 통해 대상이 전송한 내용을 정확히 확인할 수 있습니다.
  • Playground request는 선택한 키를 기준으로 요금이 청구됩니다. 프로덕션 사용량을 깔끔하게 유지하려면 가벼운 탐색용으로 전용 저용량 키를 사용하세요.
최근 업데이트: 2026년 6월 30일
← 계정 설정