주문을 문장으로: HTTPie로 터미널에서 API를 시험하는 손맛
요약
HTTPie는 현대적인 명령 줄 HTTP 도구로, 문법이 거의 한 문장처럼 읽힙니다. 방식, 주소, 키와 값의 쌍을 순서대로 쓰면 JSON이 자동으로 만들어지고 출력에는 색과 들여쓰기가 붙습니다.
추천- 이름
- HTTPie
- 버전
- 3.2.4
- 요금
- 무료
- 오픈소스
- 오픈소스
- 운영체제
- WindowsmacOSLinux
- 공식 사이트
- https://httpie.io/
- 업데이트
- 2026-10-06 22:32
curl은 강하지만 쓰기는 정말 힘들다
모든 개발자는 손을 벗어난 curl을 써 본 적이 있습니다. 따옴표 안의 따옴표, 이스케이프 위의 이스케이프, 한 줄이 화면 절반을 차지하고, JSON 본문에서 쉼표 하나를 찾는 데 몇 번을 시도하게 됩니다. HTTPie는 바로 그 지점에서 출발했습니다. 명령 줄을 위한 현대적인 HTTP 도구이고, 문법은 자연스러운 문장에 가깝게 설계되었습니다. 방식, 주소, 키와 값의 쌍을 순서대로 쓰고, 자료 항목은 name=John 형태로 바로 뒤에 붙입니다. JSON은 자동으로 만들어지고 손으로 이스케이프를 넣을 일이 어디에도 없습니다.

아끼는 것은 입력 시간만이 아닙니다. 일주일 뒤에도 읽히는 명령은 메모에 옮기고, 작업표에 붙이고, 동료에게 건넬 수 있습니다. 그리고 셸의 이스케이프 규칙이야말로 돌아가는 명령을 기억으로 다시 세울 수 없게 만드는 부분입니다. 그것을 걷어내면 한 번의 시도가 남길 수 있는 것이 됩니다.
읽기 편한 응답
또 하나의 장점은 돌아오는 쪽입니다. 응답 머리와 본문이 자동으로 정리되고, JSON은 들여쓰기와 열이 맞으며, 상태 번호와 방식은 의미에 따라 색이 붙어 한눈에 문제 자리를 짚을 수 있습니다. 글자의 벽을 한 자씩 헤칠 필요가 없습니다.
3.x 계열은 응답에 걸린 시간 정보를 더했고, Pie 테마와 함께 쓰면 그 시간이 초록, 노랑, 주황, 빨강으로 바뀌어 느린 지점이 측정 도구를 열지 않고도 드러납니다. 나머지도 갖춰져 있습니다. 세션으로 로그인을 되풀이하지 않기, 한 명령으로 파일 올리기, Bearer와 Basic 인증의 기본 지원, 규약과 출력 형식을 넓힐 수 있는 확장 구조, 그리고 흘러오는 응답이 스스로 굴러가는 표시입니다.
열린 커뮤니티의 오랜 친구
프로젝트는 BSD-3-Clause 허가로 GitHub에 공개되어 별이 사만 개에 가깝고, 개발 도구 사이에서 오랜 고정 출연진입니다. 명령 줄 판은 3.2.4, 이것이 현재 판입니다. curl을 대신하려는 것이 아닙니다. 스크립트와 파이프 안에서는 curl이 여전히 왕이고 그 점은 당분간 바뀌지 않습니다. HTTPie가 겨냥하는 것은 사람 쪽으로, 창구 하나를 시험하는 비용을 가능한 한 0에 가깝게 만드는 일입니다.
공식으로 기계 화면용과 브라우저용 판도 있어, 터미널에 익숙하지 않은 팀원도 다른 도구가 아니라 같은 도구로 확인할 수 있고 결과를 팀 안에서 견줄 수 있습니다.
이 분담은 분명히 적을 값이 있습니다. 이런 도구를 둘러싼 논쟁은 대개 두 상황을 섞은 데서 나옵니다. 사람의 손을 떠나 돌아가야 하는 것은 스크립트에, curl에 속합니다. 사람이 직접 치고 읽고 고치는 것은 명령을 읽을 수 있게 지켜 주는 도구에 속하고, 바로 거기서 이 도구가 본전을 뽑습니다.
세션은 실제로 가장 많은 시간을 아끼는 부분입니다. 보호된 창구는 보통 무엇을 시험하기 전에 인증이 필요하고, 스무 번째 요청에서도 그것을 손으로 되풀이하면 사람은 창구를 생각하는 대신 한 번 쓰고 버릴 스크립트를 쓰기 시작합니다. 세션을 한곳에 두면 그 우회로가 사라집니다.
흘러오는 응답도 같은 이유로 쓸모가 있습니다. 사건을 계속 보내는 창구는 본문의 끝을 기다리는 도구로는 볼 수 없습니다. 생겨나는 대로 늘어서는 모습을 보는 것이 느린 서버와 멈춘 서버를 가르는 유일한 방법인 경우가 많습니다.
자주 언급되지 않는 이점도 하나 있습니다. 읽히는 명령은 되돌아보기를 가능하게 합니다. 문제가 생겼을 때 사흘 전에 내가 어떻게 호출했는지 확인하는 편이 처음부터 다시 짐작하는 것보다 훨씬 빠릅니다.
도구는 사람에게 맞춰야 하고 사람이 도구에 맞출 일은 아니라는 생각입니다. 같은 요청이 curl에서는 주문이 되고 여기서는 문장이 됩니다. 한 번 설치해 두면 창구를 살피는 속도와 기분이 함께 나아집니다.