1. HTTPie는 어떤 도구인가
HTTPie는 HTTPie, Inc.가 제공하는 API 요청 도구입니다. 터미널에서 http·https 명령으로 쓰는 CLI와, 요청을 화면에서 편집하는 Web·Desktop이 있습니다. 이름은 같지만 설치 경로와 사용권이 같지는 않습니다. 셸에서 짧은 요청을 반복하려면 CLI, 메서드·헤더·본문과 응답을 나란히 살펴보려면 GUI를 비교하세요. 웹으로 시작할 수도 있어 데스크톱 앱 설치가 항상 필요한 것은 아닙니다.
CLI는 JSON 데이터와 HTTP 헤더·인증·파일 전송 등을 명령으로 구성합니다. Web·Desktop은 요청을 컬렉션으로 정리하고 변수·환경을 바꾸며 REST·GraphQL 요청을 편집하는 방식입니다. GUI의 Preview와 CLI의 오프라인 요청 구성은 전송할 내용을 점검할 때 유용하지만 실제 서버 응답을 대신하지는 않습니다.
CLI는 BSD-3-Clause 오픈소스입니다. Web·Desktop에는 별도 서비스 약관이 적용되며 공식 다운로드는 공개 베타로 표시됩니다. 베타를 최신 안정판으로 보거나 GUI까지 CLI와 같은 라이선스라고 판단하지 마세요. 회사에서 도입한다면 사용권과 계정 동기화 조건도 함께 살펴보는 것이 좋습니다.
2. CLI·웹·Desktop 선택
| 방식 | 맞는 상황 | 시작·구분 |
|---|---|---|
| CLI | 터미널에서 요청을 구성·반복할 때 | 공식 CLI 설치 선택. http·https 명령을 사용 |
| Web | 설치 없이 GUI를 먼저 살펴볼 때 | 웹 편집기로 시작. 브라우저 요청 제한 확인 |
| Desktop | 별도 앱 창에서 GUI로 작업할 때 | 공식 다운로드 화면에서 기기 선택. CLI 설치와 별개 |
GUI 파일을 받는 목적이면 위 Desktop 다운로드 버튼을 사용하세요. 같은 화면에서 Windows·macOS·Linux 경로를 고를 수 있습니다. CLI를 쓰려는 경우에는 터미널용 공식 설치 선택으로 이동합니다. 두 프로그램을 모두 설치해야 하는 것은 아닙니다.
로컬 API나 사내망 요청이 중요하면 요청이 나가는 위치와 브라우저 제한을 함께 확인하세요. 웹에서 실패했다고 서버가 중단됐다고 바로 판단하거나 인증서 검증부터 끄지 말고, 대상 서버·주소·허용 설정과 사용하는 클라이언트를 점검합니다.
3. 첫 요청을 확인하는 순서
- API 문서에서 메서드와 대상 주소를 확인하고, 처음에는 테스트용 조회 요청을 고릅니다.
- GUI에서는 메서드·주소를 입력한 뒤 Params·Headers·Auth·Body를 필요한 만큼 채웁니다. 주소의 쿼리와 Params가 중복되지 않았는지 확인하세요.
- GUI Preview 또는 CLI의 --offline으로 전송할 내용을 먼저 확인할 수 있습니다. 이 단계에는 서버의 응답이 없습니다.
- 실제 전송이 필요한 경우 대상·값을 다시 확인한 뒤 보냅니다. 상태 코드와 응답 헤더·본문을 함께 읽고 요청 의도와 맞는지 판단하세요.
GUI에 적은 HTTPie라는 이름과 CLI의 http·https 명령을 혼동하지 마세요. 요청을 미리 보는 것, 서버에 보내는 것, 응답을 받는 것은 서로 다른 단계입니다. 문서에 있는 예제를 실행할 때도 자신의 운영 서버나 실제 키를 그대로 넣을 필요는 없습니다.
4. 계정·저장과 사용권
Incognito는 계정 없이 쓰는 상태이며 로컬 저장을 사용합니다. 나중에 로그인하면 기존 Incognito 공간이 계정으로 동기화될 수 있습니다. 계정 없이 시작했다는 이유만으로 이후에도 데이터가 계속 로컬에만 남는다고 보지 마세요.
요청 데이터의 저장과 API 전송은 별개입니다. 키·본문이 포함된 요청을 보내면 선택한 서버와 전송 경로에 전달됩니다. 저장·동기화 조건을 확인하고, 연습에는 가짜 값을 사용하세요.
CLI 오픈소스 라이선스와 GUI 이용약관을 구분하세요. 현재 공개 베타 표시만으로 모든 향후 기능이 영구 무료라고 보장할 수는 없습니다. 필요한 GUI 기능·사용권을 공식 안내에서 확인한 뒤 도입합니다.
5. 다른 API 도구와 고를 때
기존 컬렉션·팀 작업을 이어가는 것이 목적이면 Postman, 웹에서 요청 편집을 먼저 시작하려면 Hoppscotch, 요청을 파일로 관리하려면 Bruno의 저장 방식과 공식 시작 경로를 비교하세요. 도구를 바꾸는 일과 모든 컬렉션·테스트가 그대로 이전되는 일은 다릅니다.
6. 주요 기능
- 터미널 CLI의 http·https 명령과 JSON 요청 구성
- Web·Desktop의 메서드·헤더·인증·본문 편집
- REST·GraphQL 요청과 응답 확인
- 컬렉션·변수·환경으로 요청 정리
- GUI Preview와 CLI --offline 요청 점검
- 계정 없는 Incognito와 계정 동기화 선택
7. 시스템 요구사항
- Desktop
- Windows·macOS·Linux 배포. OS·CPU·패키지는 공식 화면에서 선택
- CLI
- 운영체제의 공식 지원 패키지 방식으로 별도 설치
- 웹
- 지원 브라우저·네트워크에서 이용. 로컬/사내 API는 전송 경로 확인
- Linux GUI
- 공식 AppImage 설치 안내의 AppImageLauncher 조건 확인
- 계정·사용권
- Incognito와 계정 동기화, CLI와 GUI 약관을 각각 구분
8. 요청 방식에 맞게 시작하기
- 1.
화면 편집이 필요하면 웹 실행 또는 Desktop 다운로드를, 터미널 작업이면 CLI 설치 선택을 고릅니다.
- 2.
Desktop은 다운로드 화면에서 기기에 맞게 선택합니다. Linux는 제작자의 AppImage 설치 조건도 확인합니다.
- 3.
GUI에서 계정 없이 시작할지 동기화할지 판단합니다. CLI와 GUI의 사용권은 별도로 확인합니다.
- 4.
테스트용 요청을 만들고 메서드·대상·값을 확인한 뒤 필요할 때만 전송합니다.
9. HTTPie와 비슷한 프로그램 비교
- Postman
- 기존 컬렉션·팀 작업과 통합 API 플랫폼이 목적이면 비교하세요. HTTPie는 CLI와 GUI 중 사용할 인터페이스부터 구분합니다.
- Hoppscotch
- 웹 우선 API 편집과 선택적 Desktop·Agent 경로가 있습니다. HTTPie 터미널용 CLI와 같은 제품 방식으로 보지 말고 필요한 요청 환경을 고르세요.
- Bruno
- 요청 컬렉션을 파일로 관리하는 목적에 맞춰 비교하세요. HTTPie GUI의 계정/동기화 선택과 같은 저장 모델이라고 가정하지 않습니다.
10. 자주 묻는 질문
HTTPie를 쓰려면 Desktop과 CLI를 둘 다 설치해야 하나요?
+
아닙니다. 터미널용 CLI와 화면 편집용 GUI는 다른 이용 방식입니다. 웹으로 먼저 시작할 수도 있으므로 필요한 경로를 고르세요.
HTTPie는 모두 같은 무료 오픈소스인가요?
+
CLI는 BSD-3-Clause입니다. Web·Desktop에는 별도 약관과 현재 공개 베타 표시가 있으므로 GUI까지 같은 라이선스·영구 무료로 판단하지 마세요.
계정 없이도 사용할 수 있나요?
+
Web·Desktop은 Incognito로 시작할 수 있습니다. 로컬 저장 상태와 로그인 뒤 계정 동기화를 구분하고 실제 요청을 보내는 대상도 확인하세요.
Preview가 보이면 요청에 성공한 것인가요?
+
아닙니다. 전송할 내용을 확인하는 단계입니다. 실제 전송 뒤 상태 코드·헤더·본문을 별도로 확인해야 합니다.
다운로드는 운영체제별 버튼에서 받아야 하나요?
+
위 Desktop 다운로드 버튼 하나에서 공식 기기 선택 화면으로 이동합니다. CLI 설치는 별도의 터미널용 경로입니다.
출처: HTTPie CLI·설치·요청 예시, HTTPie GUI 제품·기능, HTTPie GUI·Incognito·저장 안내
관련 프로그램