resterm v1.5.6
HTTP, GraphQL 및 gRPC용 터미널 API 클라이언트. diff 및 버전 관리가 가능한 일반 .http 파일로, 워크플로, 목(mocks), 프로파일링, 추적(tracing), OpenAPI 가져오기, SSH 터널, Kubernetes 포트 포워딩, WebSocket, SSE 및 CLI 러너를 지원합니다.
Resterm
터미널을 위한 API-as-code 워크벤치.
resterm.app · docs
Resterm은 .http/.rest 파일을 소스 코드로 사용하는 API 클라이언트입니다. 거의 모든 기능이 .http 파일 안에 있으므로 Git이나 다른 버전 관리 시스템에서 쉽게 검토할 수 있습니다. TUI에서 직접 요청을 보내고, API 흐름을 테스트하고, HTTP 트래픽을 기록하고, 로컬 mock 서버를 실행할 수 있으며, 동일한 정의를 스크립트와 CI에서 resterm run 명령으로 실행할 수도 있습니다.
Resterm을 사용하는 이유
- 완전한 API 흐름을 테스트하세요. 로그인하고, 토큰을 캡처하고, 리소스를 생성하고, 결과를 확인하세요. 요청 파일에 직접 assertion, 루프, 조건, 재시도, 스크립트를 추가할 수 있습니다.
- 실제 트래픽을 로컬 mock으로 전환하세요. HTTP 요청과 응답을 기록한 다음, 실행 가능한 요청이나 mock 정의로 저장하세요. mock을 이를 사용하는 요청 옆에 두세요.
- 무엇이 변경되었는지 확인하세요. 환경 간 응답을 비교하고, 이전 결과와 diff하고, 요청 타이밍을 검사하고, 반복 실행을 프로파일링하세요.
- 로컬과 CI에서 동일한 검사를 실행하세요. 개발 중에는 터미널 UI를 사용하고, 그런 다음
resterm run으로 해당 파일을 실행하세요. JSON 또는 JUnit 리포트를 내보낼 수 있습니다. - 여러 프로토콜에서 작업하세요. HTTP, GraphQL, gRPC 요청을 보내고, WebSocket 및 SSE 스트림을 다루세요.
내장된 SSH 터널과 Kubernetes 포트 포워딩을 통해 배스천 뒤나 클러스터 내부의 API에 접근할 수 있습니다.
계정도, 텔레메트리도, AI 기능도 없습니다.
스크린샷
Trace and timeline
UI 더 보기를 클릭하세요
Workflows
Profiler
Explain
RestermScript
설치
macOS 및 Linux:
brew install resterm
# or
curl -fsSL https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash
Windows:
iwr -useb https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.ps1 | iex
Go 1.25 이상 사용 시:
go install github.com/unkn0wn-root/resterm/cmd/resterm@latest
macOS, Linux, Windows용 사전 빌드된 바이너리는 releases 페이지에서 확인할 수 있습니다. Linux 바이너리는 glibc 2.32 이상이 필요합니다.
업데이트하려면 Homebrew로 설치한 경우 brew upgrade resterm을 실행하세요. 그렇지 않으면 resterm --update를 실행하세요. 자세한 내용은 설치 가이드를 참조하세요.
빠른 시작
mkdir my-api && cd my-api
resterm init
resterm
resterm init은 몇 가지 샘플 요청과 이를 응답할 로컬 mock이 포함된 requests.http 파일을 생성하므로, 실제 API 없이도 시험해볼 수 있습니다. g Shift+M을 눌러 mock 서버를 시작하고, 커서를 요청으로 이동한 후 Ctrl+Enter를 눌러 전송하세요. 언제든지 ?를 눌러 도움말을 볼 수 있습니다.
init도 필요하지 않습니다. resterm을 실행하고 URL을 입력하거나 curl 명령을 붙여넣은 후 Ctrl+Enter를 누르세요.
동일한 파일은 UI 없이도 실행됩니다. 한 터미널에서 mock을 시작하고 다른 터미널에서 요청을 실행하세요:
resterm mock requests.http # terminal 1
resterm run --request CreateUser requests.http # terminal 2
요청 파일
Resterm은 표준 .http 형식을 읽고, 설정과 자동화를 위해 # @ 지시자를 추가합니다:
# @setting base-url https://api.example.com/v1/
### Create users
// Send this request once for each name in the list.
# @for-each ["david", "tom"] as name
# @when env.mode == "development"
# @assert response.statusCode == 201
POST users
Content-Type: application/json
{"name":"{{= name }}"}
첫 번째 요청 앞의 @setting은 전체 파일에 적용됩니다. ###은 새 요청을 시작합니다. 요청 위의 지시자는 요청을 반복하거나, 건너뛰거나, 응답을 검사할 수 있습니다.
더 많은 예제는 _examples/에 있으며, 모든 지시자는 요청 파일 레퍼런스에 나열되어 있습니다.
문서
전체 문서는 resterm.app/docs에 있습니다. 시작하기 좋은 곳은 workflows, mock servers, recording, the CLI, RestermScript입니다.
TUI 내에서 :help <topic>은 내장 매뉴얼을 열고, :docs <topic>은 웹사이트에서 동일한 페이지를 엽니다.
자체 Go 코드에서 요청 파일을 실행하려면 headless 패키지를 참조하세요.
후원
Resterm은 항상 무료이며 오픈 소스입니다. 제 작업이 마음에 드신다면 GitHub에서 후원할 수 있습니다.