Postman이나 Insomnia 같은 GUI 기반 API 테스트 도구는 많은 개발자에게 익숙하다. 하지만 터미널 환경에서 작업하는 개발자라면, 매번 프로그램을 전환하거나 마우스를 사용해야 하는 불편함을 느껴본 적이 있을 것이다.
Resterm은 이런 문제를 해결하기 위해 등장한 터미널 기반 REST 클라이언트이다.
HTTP뿐만 아니라 GraphQL과 gRPC까지 지원하며, .http 혹은 .rest 파일을 직접 읽어 명령행에서 API 요청을 수행할 수 있다.
Postman을 켜지 않아도, IDE를 띄우지 않아도, 오직 터미널 안에서 API 요청과 응답을 확인할 수 있는 것이 Resterm의 가장 큰 장점이다.
이 글에서는 Resterm의 주요 기능과 특징, 사용 방법, 그리고 개발자 워크플로우에서 어떤 혁신을 가져올 수 있는지를 살펴본다.
반응형
(adsbygoogle = window.adsbygoogle || []).push({});
Resterm이란 무엇인가?
Resterm은 CLI(명령줄 인터페이스) 환경에서 작동하는 REST 클라이언트이다.
주요 목적은 “터미널을 벗어나지 않고 API 요청을 수행하고 결과를 확인할 수 있는 환경”을 제공하는 것이다.
지원 프로토콜: HTTP, GraphQL, gRPC
입력 형식: .http 또는 .rest 파일
기반 인터페이스: Vim 스타일 키바인딩을 채택한 모달 편집기
즉, Resterm은 단순한 CLI 요청 도구가 아니라, 개발자의 생산성을 극대화하는 통합형 API 테스트 환경이라고 할 수 있다.
Resterm의 주요 특징
1. HTTP, GraphQL, gRPC 지원
Resterm은 다양한 API 요청 형식을 지원한다.
기존 REST API뿐 아니라 @graphql, @grpc 지시어를 사용하면 해당 요청 형식에 맞게 자동으로 포맷팅하고 메타데이터를 처리할 수 있다.
이를 통해 하나의 터미널 환경에서 서로 다른 프로토콜을 동시에 다룰 수 있다.
2. Vim 키바인딩 기반 편집기
Resterm의 인터페이스는 Vim 키바인딩을 기반으로 설계되어 있다.
시각적 선택, 복사(yank), 삭제(cut), Shift+F 검색, i와 Esc를 통한 입력/보기 모드 전환 등이 가능하다.
이 덕분에 Vim 사용자라면 학습 곡선 없이 바로 사용할 수 있다.
3. 워크스페이스 탐색기 및 증분 검색
Resterm에는 워크스페이스 탐색 기능이 내장되어 있으며, .http나 .rest 파일만 필터링하여 탐색할 수 있다.
또한 증분 검색을 통해 원하는 파일로 빠르게 이동할 수 있어, 대규모 프로젝트에서도 효율적인 API 요청 관리가 가능하다.
4. 인라인 요청 실행
별도의 파일을 작성하지 않고도 URL만 입력한 뒤 Ctrl + Enter를 누르면 즉시 요청을 실행할 수 있다.
이 기능은 간단한 API 테스트나 응답 확인 시 매우 유용하다.
5. Curl 명령어 파싱
Resterm은 curl 명령어를 해석해 요청으로 변환할 수 있다.
기존에 사용하던 curl 명령을 그대로 Resterm으로 옮겨와 활용할 수 있어, CLI 사용자에게 친숙한 사용 경험을 제공한다.
응답 패널과 결과 분석
Resterm은 상태 인식형 응답 패널을 제공한다.
응답 화면 상단에는 현재 워크스페이스, 환경, 실행 중인 요청, 스크립트 및 테스트 결과가 표시된다.
응답 영역은 다음과 같이 구성된다.
Pretty: 가독성 높은 포맷으로 응답 데이터를 표시
Raw: 원본 응답 데이터 확인
Headers: 응답 헤더 정보 확인
History: 이전 요청 및 응답 이력 관리
또한 응답 패널을 세로 또는 가로로 분할하여 여러 요청의 결과를 동시에 비교할 수 있다.
pin 기능을 활용하면 특정 탭을 고정하여 Pretty / Raw / Headers 탭을 나란히 확인하거나, 통합 Diff 뷰로 응답 차이를 비교할 수도 있다.
인증 및 내장 헬퍼 기능
Resterm은 다양한 인증 방식을 지원한다.
Basic
Bearer Token
API Key
사