Playground 기능이 Dashboard에 적용되었습니다. 3개의 endpoint, 단일 cookie jar, 모든 header 파싱을 지원합니다. Single, Proxy, Browser 중 하나를 선택하고 request를 입력한 뒤 Send를 누르십시오. 동일한 화면에 상태 코드, header, body, 파싱된 cookie가 포함된 response가 표시됩니다. 결과가 만족스러우면 동작하는 curl 명령어를 코드에 바로 복사하십시오.
이 기능은 별도 페이지나 다른 URL 뒤에 격리된 샌드박스가 아닙니다. 실제 API 키를 사용하여 실제 API를 대상으로 실행됩니다. Playground에서 확인한 결과는 프로덕션 코드가 수신하게 될 결과와 동일합니다.
동작 방식
Dashboard에 로그인하여 3개 endpoint 중 하나를 선택하면, 해당 endpoint가 실제로 허용하는 필드만 표시되도록 폼이 자동으로 재구성됩니다.
- Single은
url,method,headers,unblocker,proxy,tryJsonData,followRedirects및 timeout 그룹을 지원합니다. - Proxy는 동일한 필드 세트를
request블록 하위에 포함하며, proxy 선택 필터(국가, 도시, ASN, 익명성, 최신성)가 추가됩니다. - Browser는
url,cookies,headers및 wait 조건을 지원합니다.
Send를 누르면 Dashboard가 계정을 기반으로 호출을 인증하고 api.foura.ai의 /api/{endpoint} 경로로 POST 요청을 보냅니다. 실제 API 키는 브라우저를 통해 전송되지 않습니다. Playground는 브라우저에 키를 노출하지 않고 과금 대상 request를 전송할 수 있는 Dashboard 내 유일한 영역입니다.
기본 Single request에 대해 Playground에서 생성되는 curl 재현 코드입니다.
curl -X POST 'https://api.foura.ai/api/single' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
--data-raw '{
"url": "https://example.com/products",
"method": "GET",
"unblocker": true,
"tryJsonData": true
}'
터미널이나 빌드 스크립트에 그대로 붙여넣으면 Send 버튼과 완전히 동일하게 동작합니다. 페이로드를 커스텀 엔벨로프로 감싸거나 필드명을 변경하지 않습니다. Playground는 API가 받는 그대로 전송합니다. 끝입니다.
응답 확인 항목
응답 패널에는 업스트림 상태, 총 소요 시간, (Proxy 호출의 경우) 요청을 처리한 proxy id가 표시됩니다. Body, Headers, Cookies는 각각 별도 탭으로 분리되어 있습니다.
Body. 자동으로 감지된 JSON은 접을 수 있는 뷰어로 렌더링됩니다. HTML 페이로드는 미리보기 창으로 전환되어 대상 사이트가 반환한 결과를 시각적으로 확인할 수 있습니다. 일반 텍스트는 고정폭 폰트 뷰로 표시됩니다. Body 및 Raw에는 이전/다음 이동 기능이 포함된 검색창이 있습니다.
Headers. name: value당 한 행씩 보여주는 파싱된 뷰나, 전체 멀티홉 응답 체인을 보여주는 Raw 뷰를 지원합니다. 모든 리디렉션은 고유한 헤더 세트를 남기므로, 클릭 한 번으로 302를 최종 대상까지 추적할 수 있습니다.
Cookies. 쿠키 jar는 응답의 모든 Set-Cookie 라인을 파싱하고, 각 쿠키가 호스트 전용인지 도메인 전체인지(RFC 6265 §5.3) 추적하며, 호스트별 접이식 카드 뷰 또는 원시 목록 뷰를 제공합니다. jar를 활성화하면 다음 요청 시 일치하는 쿠키를 자동으로 가져옵니다. Single 및 Proxy의 경우 이는 발신 요청의 Cookie 헤더를 의미합니다. Browser의 경우 요청 객체에 첨부된 쿠키 배열을 의미합니다.
Preset을 사용하면 전체 요청 설정을 이름 및 설명과 함께 저장할 수 있으므로, 다시 구성할 필요 없이 "staging 로그인 테스트"로 바로 돌아갈 수 있습니다. History에는 최근 20회의 실행 기록이 상태, 컨텐츠 타입, 총 소요 시간, 사용된 proxy와 함께 보관됩니다.
도입 효과
Playground가 실제로 바꾸는 것은 반복 작업 루프입니다.
이전에는 간단한 스크립트(Node, Python 또는 셸)를 작성하고, 키를 연결하고, API를 호출하고, 본문을 출력하고, 헤더 하나를 수정한 뒤 다시 실행했습니다. "이 사이트가 무엇을 반환할까"라는 궁금증에서 답을 얻기까지 아마 10분 정도 걸렸을 것입니다.
Playground에서는 이 과정이 15초에 가깝게 줄어듭니다. endpoint를 클릭하고, URL을 붙여넣고, Send를 누르고, 쿠키를 확인하고, unblocker를 off에서 on으로 변경한 다음 다시 Send를 누르면 됩니다. 에디터를 열었을 즈음에는 이미 대상에 작동하는 요청 버전을 파악한 상태가 됩니다.
프로덕션 코드를 대체하려고 Playground를 출시한 것이 아닙니다. "이 사이트에서 가능한 작업인가"에서 "작동하는 curl 명령어는 이것이다"까지 가는 과정에 불필요한 부수 작업이 들지 않도록 하기 위해 만들었습니다.
고급 사용자를 위한 팁
겉으로 바로 드러나지 않는 몇 가지 사항입니다.
Preset은 전체 페이로드를 보관합니다. 여기에는 타임아웃 그룹, 유효성 검사 규칙, 리디렉션 제한, 커스텀 헤더가 모두 포함됩니다. Preset을 저장하면 URL뿐만 아니라 검증된 요청 전체가 스냅샷으로 저장됩니다. 여러 endpoint에 걸쳐 안정적인 스모크 테스트 세트를 유지할 때 유용합니다.
쿠키 jar는 세션별로 유지됩니다. 브라우저 내에 저장되며, 캡처된 쿠키를 서버 측에 보관하지 않습니다. 초기화된 상태가 필요하다면 탭을 새로고침하십시오.
Raw 탭과 폼은 항상 동기화 상태를 유지합니다. 폼 필드는 Raw 탭에 표시되는 것과 동일한 JSON을 렌더링합니다. 페이로드를 Raw에 붙여넣으면 폼이 자동으로 다시 채워집니다. 따라서 동료가 채팅에 정상 작동하는 요청을 공유하면, 이를 Raw에 붙여넣어 폼을 바로 자동 완성할 수 있습니다.
브라우저 쿠키는 헤더 형식이 아니라 객체 형식입니다. Browser 엔드포인트에 쿠키를 직접 전송하는 경우, 각 항목은 {name, value, domain?, path?, httpOnly?, secure?, sameSite?} 형식을 따릅니다. jar 옵션이 켜져 있으면 Playground가 이를 올바르게 구성합니다. 직접 작성하는 경우에는 스키마 일치 여부가 중요합니다.
결과는 활동 피드에 표시됩니다. Playground에서 요청을 실행하면 API 키에 대한 다른 호출과 동일하게 집계됩니다. 활동 로그에서 적절한 결과 라벨(success, client_error, application_error, rate_limit, service_error)과 함께 확인할 수 있습니다. 간헐적으로 실패하는 프로덕션 호출을 재현할 때 유용합니다. Playground에서 다시 실행하고, 활동 로그에서 찾은 뒤, 해당 링크를 팀과 공유하세요.
향후 계획
Playground는 대시보드가 단순한 과거 작업 내역 조회를 넘어 더 많은 기능을 수행하도록 개선하는 첫 번째 단계입니다. 요청 로그에서 확인되는 패턴은 다음 배포 기능을 결정하는 데 반영됩니다.
현재 사용 중 문제가 발생하거나, 문서와 일치하지 않는 필드, 리디렉션 시 유지되지 않는 쿠키, 비정상적으로 렌더링되는 응답 등이 있다면 해당 피드백을 최우선으로 검토합니다. 대시보드는 요청을 기록하고, 저희는 그 트렌드를 분석합니다.