플레이그라운드

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 키를 사용하여 실행됩니다. 사용량은 프로덕션 호출과 동일한 방식으로 해당 키의 할당량에서 차감되므로 테스트 중 요금제를 낭비하지 마십시오.

키 선택

API 키 드롭다운에는 권한 내의 모든 활성 키(개인 키, 관리 중인 조직 키, 액세스 가능한 팀 공유 키)가 표시됩니다. Request 요금을 청구할 키를 선택합니다. 아직 활성 키가 없는 경우 인라인 프롬프트에서 키를 생성할 수 있도록 API Keys 페이지로 연결됩니다.

모드 선택

상단의 Mode 행은 Auto와 수동 엔진 간을 전환합니다. Auto를 선택하면 양식이 최소한의 Auto 화면(URL, validate 및 몇 가지 설정)으로 전환됩니다. Auto를 끄면 Single, Proxy, Browser 세 가지 옵션이 나타납니다. 옵션을 전환하면 표시되는 필드와 Request를 처리하는 엔진이 바뀝니다. 페이지를 새로 고침해도 현재 선택 항목이 유지됩니다.

Mode	사용 시기
Auto	새로운 대상 또는 혼합 보호 사이트. Auto는 가장 저렴한 경로를 선택하고 작동하는 방식을 기억합니다.
Single	빠른 HTTP fetch. 알려진 호스트를 위한 최고의 첫 번째 선택입니다.
Proxy	자동 proxy 순환 기능이 있는 동일한 fetch. 대상에서 볼 수 있는 국가가 필요한 경우 `exitCountries`를 설정합니다.
Browser	Chrome 브라우저 인스턴스에서 페이지를 로드합니다. JavaScript 실행 후에만 데이터가 나타나는 경우에 사용합니다.

Request 빌드

URL 행

맨 윗줄에는 HTTP 메서드(GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), 대상 URL 및 Send 버튼이 있습니다. Single, Proxy 및 Auto는 모든 메서드를 준수합니다. Browser는 메서드(Chrome은 탐색을 위해 항상 GET을 실행함)와 body를 무시합니다.

Request 탭

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

탭	제어 대상
UI	timeout, redirect, 플래그, proxy, 브라우저별 옵션 및 검증 규칙을 위한 양식 필드
Body	POST / PUT / PATCH request를 위한 자유 형식 body
Headers	키-값 쌍 형태의 사용자 지정 request header
Cookies	request와 함께 보낼 cookie
Raw	직접 편집할 수 있으며 전송될 정확한 JSON 페이로드

UI / Body / Headers / Cookies에서 변경한 내용은 Raw에 반영됩니다. Raw를 직접 편집해도 되며 다른 탭도 이에 맞춰 업데이트됩니다. 엔진 기본값과 다른 값을 가진 탭이나 접을 수 있는 섹션에는 빨간색 점이 표시되므로 맞춤설정한 내용을 한눈에 파악할 수 있습니다.

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, Auto에 적용됩니다. Browser는 자체적으로 리디렉션을 따릅니다.
Flags: Single, Proxy, Browser용 unblocker(Browser에서 Unblocker를 사용하면 자동 방어 솔버가 트리거됨), Single 및 Proxy용 tryJsonData 및 returnBuffer. Auto는 대신 forceProxy 및 returnSession를 노출합니다.
Proxy: Single 또는 Browser용 특정 프록시 ID를 선택하거나 Proxy 외부 시간 초과인 maxTries, Proxy 엔진용 exitCountries 및 ignoreProxies를 설정합니다. Auto는 ignoreProxies도 노출합니다.
Browser profile: os, browser, version 등 3개의 계단식 드롭다운으로 FourA가 실제로 표시할 수 있는 항목을 나열합니다. Single 및 Proxy 모드에 표시됩니다. 최신 Chrome을 사용하려면 비워 둡니다. 각 선택 항목은 다른 두 항목의 범위를 좁히므로 결과가 없는 조합은 표시되지 않습니다. 이 섹션은 Web Unblocker를 켜야 합니다. 끄면 브라우저 헤더가 전송되지 않고 프로필이 절반만 적용되며 API가 대신 요청을 거부합니다.
Browser: checkStatus 및 checkText과 같은 브라우저 전용 옵션입니다.
Validate: validate.status(상태 코드), validate.headers(헤더 키-값 규칙), validate.data(본문 허용/실패 부분 문자열, |로 구분된 대안) 허용/실패 규칙입니다. Auto를 포함한 모든 Mode에서 사용할 수 있습니다.

출구 국가 지정(Proxy 모드)

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

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

도구 모음 재설정

툴바(History 및 Saved 옆)의 Reset 버튼은 플레이그라운드를 초기 상태로 지웁니다. 이 작업은 파괴적이므로, 세 가지 제품 양식(Single, Proxy, Browser), 저장된 모든 cookie, 가져온 모든 proxy 및 현재 response 등 삭제되는 항목을 정확히 나열하는 확인 대화상자가 열립니다. 저장된 프리셋과 선택한 API 키는 유지됩니다. 확인하려면 Reset everything을 클릭하고, 취소하려면 다른 항목을 클릭하십시오.

전송 및 취소

Send를 클릭하여 request를 실행합니다. 호출이 진행되는 동안 오른쪽 열은 스피너와 Cancel 버튼이 있는 로딩 상태로 전환됩니다. 중단하려면 Cancel을 클릭(또는 모바일에서는 버튼을 다시 누름)하십시오. 취소된 request는 에러를 렌더링하는 대신 "Request canceled."라는 유휴 자리 표시자를 복원합니다.

request가 완료(또는 실패)되는 즉시 response 카드가 결과로 전환됩니다. 콜드 타겟의 경우 사다리가 여러 단계를 올라갈 수 있으므로, Auto 실행은 수동 엔진보다 시간이 더 걸릴 수 있습니다.

Response 읽기

response 열은 고유한 탭을 사용하여 request 레이아웃을 반영합니다.

탭	표시 내용
Body	파싱된 body입니다. 반환된 내용에 따라 JSON, HTML 및 Text 보기 간에 전환됩니다.
Headers	라인당 하나의 Response header입니다.
Cookies	타겟에서 반환된 cookie로, 파싱된(호스트 그룹화) 보기와 원시(Set-Cookie 텍스트) 보기로 표시됩니다. 파싱된 보기에는 호스트 전용 cookie에 `HO` 배지가 표시되며, 도메인 cookie는 표시되지 않습니다.
Raw	API에서 반환한 전체 JSON 엔벌로프입니다.

탭 위의 메타 스트립에는 업스트림 HTTP 상태, 총 시간, 호출을 처리한 proxy ID, 그리고 (스코프된 Proxy 호출의 경우) 두 글자의 exit <CODE>가 표시됩니다. Auto 실행의 경우, 스트립에는 response를 전달한 사다리 단계, 수행된 하위 시도 횟수 및 사용된 크레딧도 표시됩니다.

실행 간 값 전달

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

Auto 실행은 전체 session 트리플(proxy, cookies, userAgent)을 제공합니다.
Browser 실행은 response userAgent과 함께 사용된 경우 proxy ID를 제공합니다.
Proxy 실행은 반환된 proxy ID를 제공합니다.

Carry를 클릭하고 클릭 한 번으로 각 값을 적용할 위치를 선택하십시오. userAgent은 Single 또는 Proxy에서 User-Agent header가 되고, proxy ID는 Single 또는 Browser의 proxy 필드에 들어갑니다. 전달된 값을 수신하는 필드에는 "수정됨" 빨간색 점이 표시되어 변경된 내용을 확인할 수 있습니다.

전체 화면으로 확장

response 툴바의 확장 아이콘은 분할 레이아웃에서 response 카드를 들어올려 전체 화면 오버레이로 전환합니다. 깊은 JSON 트리, 긴 Set-Cookie 덤프, 또는 반폭 열이 비좁아지는 넓은 HTML body에 사용하십시오. 오버레이가 열려 있는 동안에는 페이지 자체의 스크롤이 중지됩니다. 아이콘을 다시 클릭(또는 Escape를 누름)하면 축소됩니다.

curl 재현 도구

response 아래의 curl 블록은 방금 생성한 request와 동일한 정확한 명령줄을 표시합니다. 이를 복사하여 터미널에서 request를 재현하거나, 팀원과 공유하거나, 버그 리포트에 붙여넣으세요.

표시 가능한 키의 경우, 스니펫 옆의 Reveal key 버튼을 클릭하면 실제 일반 텍스트 키가 curl에 바로 입력되어 그대로 복사하여 실행할 수 있습니다. 숨기려면 다시 클릭하세요. 레거시 키(표시 기능이 출시되기 전에 생성됨)는 PASTE_PLAINTEXT_FOR_<key-name> 자리 표시자를 유지합니다. 키를 표시할 수 있게 하려면 API Keys 페이지에서 키를 다시 생성하세요.

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

프리셋 저장

동일한 대상을 반복적으로 재구성하는 경우 이를 저장하세요. request 탭 행에서 Save를 클릭하여 현재 구성을 이름이 지정된 프리셋으로 저장합니다.

툴바에서 Saved를 열어 프리셋을 찾아보거나, 이름을 바꾸거나, 삭제하세요. 폼에 다시 로드하려면 프리셋을 클릭하세요.

프리셋 필드	저장 내용
Name	짧은 레이블(최대 100자)
Description	선택적 참고 사항(최대 500자)
Endpoint	프리셋이 대상하는 엔진(auto / single / proxy / browser)
Config	UI 필드, header, cookie 및 body를 포함한 전체 request 페이로드

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

기록에서 다시 재생

실행하는 모든 request가 로깅됩니다. 툴바에서 History를 열어 가장 최신 순으로 정렬된 최근 20개의 실행을 확인하세요.

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

기록은 자동으로 계정으로 범위가 지정됩니다. 사용자는 자신의 실행만 볼 수 있습니다.

활동에서 열기

Activity Log 세부 정보 대화 상자에는 Open in Playground 버튼이 있습니다. 이를 클릭하면 보관된 request와 보관된 response 모두와 함께 Playground가 로드됩니다. 저장된 페이로드에서 폼이 채워지고, response 카드에는 proxy 메타 스트립에 "archived" 배지와 함께 해당 순간에 API가 반환한 내용이 표시됩니다("archived [, truncated] [, via ]").

여기서 매개변수를 변경하고 Send를 눌러 라이브 API에 대해 새 request를 실행하거나, 다시 실행하지 않고 보관된 페이로드만 검사할 수 있습니다. 페이로드는 24시간 동안 유지되므로 이전 활동 행에는 다시 로드할 수 있는 response가 없습니다.

팁

새로운 타겟에 대한 코드를 작성하기 전에 Playground에서 시작하십시오. Auto를 켜면 저렴한 fetch로 충분한지 아니면 사이트에서 강제로 브라우저를 해결해야 하는지 몇 초 안에 알 수 있습니다.
국가 제한이 있는 타겟의 경우 exitCountries을(를) 설정하여 Proxy 호출을 한 번 실행한 다음 반환된 proxy ID를 Browser 호출로 가져와서 동일한 출구를 통해 JavaScript 렌더링이 발생하도록 하십시오.
정기적으로 스크래핑하는 모든 타겟에 대해 프리셋을 저장하십시오. 저장된 프리셋을 다시 재생하는 데는 클릭 한 번이면 되지만 메모리에서 request를 재구성하는 데는 시간이 더 오래 걸립니다.
세션 기반 스크래핑을 디버그하려면 Cookies 탭을 사용하십시오. 원시 Set-Cookie 보기는 타겟이 보낸 내용을 정확히 보여줍니다.
타겟이 거부하면 더 무거운 엔진을 사용하기 전에 Browser 프로필 선택에서 다른 항목을 시도하십시오. 제시된 브라우저를 교체하는 것은 무료이지만 브라우저 렌더링은 그렇지 않습니다.
Playground request는 선택한 키에 대해 청구됩니다. 프로덕션 사용량을 깔끔하게 유지하려면 가벼운 탐색을 위해 전용 저할당량 키를 사용하십시오.