기록 세션

기록 세션은 사용자가 웹 페이지를 사용하는 동안 그 페이지를 관찰하고, 페이지가 수행하는 모든 API 호출을 기록합니다: REST, GraphQL, gRPC-web, WebSocket. 캡처된 호출은 일반 응답처럼 살펴볼 수 있으며, Pro 및 Enterprise 플랜에서는 페이지가 실제로 보낸 내용이 미리 채워진 다시 실행할 수 있는 실제 요청 폴더로 바뀝니다.

프런트엔드만 가지고 있는 API를 문서화하는 가장 빠른 길입니다. 설정할 프록시도, 설치할 인증서도, 브라우저 확장 프로그램도 필요 없습니다.

세션 만들기

세션은 트리의 어디에서나(루트, 폴더 또는 환경 폴더) 컨텍스트 메뉴(“추가” → “기록 세션”)나 “만들기” 메뉴에서 만들 수 있습니다. 시나리오만은 세션을 담을 수 없습니다. 세션은 사이드바에 부모 노드로 표시됩니다. 세션 자체를 클릭하면 설정 페이지가 열리고, 자식 행은 각각 자기 탭을 엽니다.

기록 세션의 설정 페이지: 페이지 url, 기록할 프로토콜, 허용 목록과 차단 목록, 그리고 기록 시작 버튼

설정은 네 가지 요소로 이루어집니다.

미니 브라우저에서 열 페이지 url(http://, https:// 또는 file://). url이 유효해질 때까지 “기록 시작” 버튼은 비활성 상태로 남습니다.
기록할 프로토콜: HTTP, WebSocket, GraphQL, gRPC-web — 기본적으로 모두 선택되어 있습니다.
허용 목록: 정규 표현식입니다. 그중 하나 이상과 일치하는 호출이 유지됩니다. 비어 있으면 모든 호출을 통과시킵니다.
차단 목록: 정규 표현식입니다. 그중 하나와 일치하는 호출은 버려집니다. 차단 목록이 항상 최종 결정권을 가집니다.

프로젝트 파일에는 이 설정과 추론된 경로만 저장됩니다. 캡처된 호출은 메모리에만 남습니다. 프로젝트를 닫으면 사라지며 디스크에 기록되는 일은 없습니다.

기록하기

“기록 시작” 버튼은 미니 브라우저 탭에서 페이지를 열고 첫 로드 전에 레코더를 연결합니다. 그래서 페이지가 시작하면서 수행하는 호출도 — 즉시 열리는 WebSocket 연결을 포함해 — 캡처됩니다. 사이드바에 있는 세션의 배지와 그 탭 주위에서 맥동하는 빛이 기록이 진행 중임을 나타냅니다.

기록 중인 미니 브라우저: 사이트 페이지, 주소 표시줄의 기록 일시 중지 및 기록 중지 버튼, 세션에 붙은 빨간 배지

페이지를 평소처럼 탐색하고 사용하십시오. 주소 표시줄의 두 버튼이 세션을 제어합니다.

기록 일시 중지는 페이지를 열어 둔 채 호출 저장만 멈춥니다 — 관심 없는 화면을 지나갈 때 유용합니다.
기록 중지는 레코더를 분리하고 브라우저 탭을 닫습니다. 캡처는 그대로 남습니다.

기록은 언제나 명시적인 동작입니다. 애플리케이션을 다시 열 때 복원된 브라우저 탭은 아무것도 기록하지 않습니다.

위치가 필요한 사이트는 브라우저에 위치를 요청하지만, 기본적으로 미니 브라우저는 아무것도 알려주지 않습니다. 애플리케이션 설정의 개인정보 보호 섹션에 있는 내장 브라우저와 위치 공유 설정(기본값은 꺼짐)은 동의를 요청한 뒤 대략적인 위치를 제공합니다. 위치는 시스템의 위치 서비스에서 가져오며, 사용할 수 없으면 IP 주소를 기반으로 한 도시 수준의 추정치를 사용합니다. 끄면 위치를 즉시 삭제합니다.

캡처

세션의 “캡처” 행을 열면 실행별로 오래된 것부터 최신 순으로 묶이고 기록 중에는 실시간으로 갱신되는 호출 보기가 나타납니다. 목록을 맨 아래까지 스크롤해 두면 최신 호출을 따라갑니다. 위로 스크롤하여 호출을 읽으면 목록은 그 자리에 머무릅니다. 필터 필드로 목록을 좁힐 수 있습니다. 호출의 상세 내용은 요청의 응답 탭(본문, 정보, 쿠키, 그래프)을 프로토콜별로 그대로 재사용합니다.

캡처 보기: 왼쪽에는 실행별로 묶인 호출 목록, 오른쪽에는 선택한 호출의 상세 내용과 응답 탭

호출의 컨텍스트 메뉴에는 “허용 목록에 추가…”와 “차단 목록에 추가…”가 있으며, 호출의 url이 패턴으로 미리 채워집니다. 새 패턴을 이미 캡처된 호출에도 적용할 수 있습니다. 더 이상 통과하지 못하는 호출은 영구적으로 삭제되므로 애플리케이션이 확인을 요청합니다.

세션별로 유지되는 호출 수에는 상한이 있습니다(기본 1,000개, 애플리케이션 설정에서 조정 가능). 상한을 넘으면 가장 오래된 호출부터 삭제됩니다.

경로 추론하기

Pro 및 Enterprise 플랜에서는 캡처 보기의 경로 추론 버튼이 호출을 세션의 “경로” 행 아래 트리로 변환합니다.

호출은 경로별로 묶입니다. 호출마다 달라지는 경로 세그먼트(/pets/1, /pets/2)는 {{petId}} 경로 매개변수가 됩니다.
폴더는 경로의 고정 접두사(api › pets)를 따릅니다. gRPC-web 호출은 서비스별로 정리됩니다.
각 경로는 일반 요청이 됩니다 — HTTP, GraphQL, gRPC-web 또는 WebSocket — 마지막으로 성공한 호출의 내용(헤더, 매개변수, 본문)이 미리 채워져 있어 즉시 다시 실행할 수 있습니다.
캡처된 호출은 각 요청의 응답 기록에 평소 형식으로, 설정된 보존 한도 안에서 기록됩니다. 기본으로 표시되는 응답은 마지막으로 성공한 호출의 응답입니다.

펼쳐진 세션의 경로 행: 추론된 폴더와 그 요청들이 다시 실행할 준비가 된 모습

새로 기록한 뒤 추론을 다시 실행하면 결과가 병합됩니다. 새 경로만 추가되고, 기존 요청은 — 사용자가 수정한 것을 포함해 — 그대로 유지됩니다.

Community 플랜에서도 기록과 캡처 살펴보기는 전부 사용할 수 있습니다. 경로 탭에는 Pro 기능이라는 안내가 표시됩니다.

AI 어시스턴트에서

이 기능 전체가 Restorm MCP 서버를 통해 제공됩니다. 세션 생성과 설정, 기록 시작과 중지, 캡처 읽기, 경로 추론까지. 에이전트는 페이지를 열고 잠시 동작하게 둔 뒤, 바로 사용할 수 있는 요청 폴더를 건네줄 수 있습니다.