1. Hoppscotch는 어떤 도구인가
Hoppscotch는 Hoppscotch Limited의 API 개발·테스트 도구입니다. 브라우저에서 메서드·주소·헤더·본문을 편집해 요청을 만들 수 있고, 필요하면 Windows·macOS·Linux용 공식 Desktop을 선택할 수 있습니다. 가볍게 요청을 확인하려는 사용자에게 웹 시작이 열려 있으므로 서버를 직접 구축하거나 데스크톱 앱을 먼저 설치해야만 쓸 수 있는 제품은 아닙니다.
REST뿐 아니라 GraphQL과 Realtime 도구를 제공하며, 요청을 컬렉션으로 정리하고 환경·변수·스크립트·테스트를 사용할 수 있습니다. 중요한 선택은 웹 편집 화면과 실제 요청이 나가는 경로입니다. 웹에서 브라우저 제한을 만났을 때 쓰는 Agent, 별도 창으로 실행하는 공식 Desktop, 터미널/CI용 CLI는 같은 역할이 아닙니다.
개인용 Free와 팀 협업용 유료 Cloud, 직접 운영하는 Self-host의 조건을 구분해야 합니다. Community Edition의 MIT 오픈소스와 기업 서비스의 제공 범위도 같다고 볼 수 없습니다. 자신에게 필요한 요청·저장·협업 방식부터 고르고, 설치 파일이나 운영 서버를 준비하는 일은 그 선택에 필요한 경우에 진행하세요.
2. 웹·앱과 요청 전송 경로
| 선택 | 역할 | 고를 때 |
|---|---|---|
| Web | 브라우저에서 API 요청 편집 | 설치 없이 기본 요청부터 시작 |
| 공식 Desktop | Tauri 기반 독립 앱 | 앱 창에서 작업하거나 Cloud/조직 인스턴스에 연결 |
| Agent | 웹의 요청 실행을 돕는 별도 도구 | 브라우저 제한·로컬 네트워크 조건을 확인한 경우 |
| CLI | 터미널·CI에서 컬렉션 실행 | 화면 편집보다 자동 실행이 목적일 때 |
| Self-host | 자신의 인프라에서 서비스 운영 | 서버 운영·관리 책임까지 맡을 때 |
데스크톱 앱이 필요하면 위 다운로드 버튼에서 공식 기기 선택 화면으로 이동하세요. WebCatalog 같은 웹 래퍼와 공식 Hoppscotch Desktop은 다른 배포입니다. 일반 웹 사용을 시작하기 위해 서버를 직접 구축할 필요는 없습니다.
CORS나 로컬 API 연결 문제는 API 주소·브라우저·요청 전송 방식에 따라 달라집니다. Agent는 로컬 네트워크를 이용하는 경로이고 프록시는 별도의 중계 경로가 될 수 있습니다. 어떤 서버로 요청·인증값이 전달되는지 확인한 뒤 선택하며 인증서 검증 해제를 기본 해결 단계로 삼지 않습니다.
3. REST 요청 시작
- 웹 편집기의 REST에서 API 문서에 맞는 메서드와 주소를 입력합니다. 처음에는 테스트용 조회 요청을 고르세요.
- 파라미터·헤더·인증·본문 탭에 필요한 항목만 채웁니다. 주소 쿼리와 파라미터를 두 번 넣거나 GET 예제에 임의 본문을 추가하지 않습니다.
- 보내기 전에 대상과 값, 현재 환경·변수, 사용할 요청 전송 방식을 확인합니다. 웹에서는 브라우저 제한도 영향을 줍니다.
- 전송 뒤 상태와 응답 본문·헤더를 확인합니다. 오류가 나면 응답을 받은 API 오류인지, 요청이 도달하지 못한 연결 문제인지부터 나눠 살펴봅니다.
화면이 열리거나 요청이 저장된 상태와 API 응답 성공은 다릅니다. 로컬 API가 대상이면 그 서버가 실행 중인지도 확인해야 합니다. 연결 실패를 없애려고 다른 도구 설치·프록시 변경부터 반복하기보다 현재 대상과 실행 경로를 먼저 확인하세요.
4. 개인·팀과 저장 범위
현재 Free는 Personal workspace와 기본 API 테스트 기능을 제공하며, Cloud의 팀 workspace·공동 작업은 유료 플랜 범위를 확인해야 합니다. Self-host Community Edition과 Enterprise도 나눠 봐야 하며 Cloud 요금을 자체 운영 비용과 같은 것으로 계산하지 않습니다.
로그인 전에도 웹 편집 화면을 살펴볼 수 있습니다. 기기를 바꿔 이어 쓰거나 팀과 공유하려면 로그인한 workspace와 인스턴스, 공유 범위를 확인하세요. 익명 편집 상태를 장기 클라우드 백업처럼 믿거나 민감한 요청을 연습 자료로 사용하지 않는 것이 좋습니다.
데스크톱 앱에서도 개인 Cloud·조직·자가 호스팅 인스턴스 연결을 구분합니다. 앱이 내 PC에 설치돼 있다는 이유만으로 컬렉션과 계정 데이터가 모두 로컬에만 보관된다고 단정하지 마세요.
5. 다른 도구를 비교할 때
6. 주요 기능
- 웹 REST 요청의 메서드·파라미터·헤더·인증·본문 편집
- GraphQL과 Realtime API 도구
- 컬렉션·환경·변수로 요청 정리
- 요청 전후 스크립트와 테스트·Runner
- 요청 코드 스니펫 생성과 cURL 가져오기
- 웹·공식 Desktop·터미널 CLI 선택
7. 시스템 요구사항
- 웹
- API를 편집할 브라우저와 대상 서버 연결. 브라우저 요청 제한은 환경별 확인
- Desktop
- Windows·macOS·Linux 공식 배포. 기기·패키지는 제작자 화면에서 선택
- 로컬 API
- 대상 서버 실행과 Agent/클라이언트의 실제 네트워크 경로 확인
- 계정·인스턴스
- 개인 Cloud·조직·자가 호스팅의 로그인/공유 범위 구분
8. 웹 또는 앱으로 시작하기
- 1.
간단한 웹 API 테스트는 위 웹 시작 버튼에서 REST 편집기를 엽니다.
- 2.
별도 앱이 필요하면 Desktop 다운로드 화면에서 운영체제와 패키지를 선택해 설치합니다.
- 3.
개인 Cloud·조직·자가 호스팅 중 사용할 인스턴스와 계정·공유 범위를 구분합니다.
- 4.
테스트 요청을 만들고 대상·값·전송 방식을 확인합니다. 브라우저 제한이 있을 때만 필요한 실행 보조 경로를 검토합니다.
9. Hoppscotch와 비슷한 프로그램 비교
10. 자주 묻는 질문
Hoppscotch는 꼭 설치해야 하나요?
+
아닙니다. 웹 시작 버튼에서 요청 편집기로 이동할 수 있습니다. 별도 앱이 필요한 경우에만 공식 Desktop 다운로드를 선택하세요.
Desktop과 Agent는 같은 프로그램인가요?
+
Desktop은 독립 앱이고 Agent는 웹에서 요청 실행을 돕는 도구입니다. 로컬 API·브라우저 제한 등 실제 조건을 보고 선택하며 무조건 둘 다 설치할 필요는 없습니다.
웹 앱을 쓰려면 직접 서버를 구축해야 하나요?
+
일반 사용은 제공되는 웹 앱으로 시작할 수 있습니다. Self-host는 자체 인프라 운영이 필요한 경우의 별도 선택입니다.
팀에서도 전부 무료인가요?
+
개인 Free와 Cloud 팀 workspace·공동 작업의 유료 범위를 구분하세요. Community Edition의 오픈소스와 Cloud/Enterprise 서비스 조건도 같지는 않습니다.
공식 앱은 어디서 받나요?
+
위 Desktop 다운로드 버튼 하나로 공식 기기 선택 화면에 연결됩니다. 별도 웹 래퍼의 설치 경로와 구분하세요.
출처: Hoppscotch 공식 시작·제품 방식, Hoppscotch 공식 Desktop 다운로드, 공식 Desktop 제품 설명
관련 프로그램