주문을 문장으로: 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은 자동으로 만들어지고 손으로 이스케이프를 넣을 일이 어디에도 없습니다.

터미널 안의 HTTPie

아끼는 것은 입력 시간만이 아닙니다. 일주일 뒤에도 읽히는 명령은 메모에 옮기고, 작업표에 붙이고, 동료에게 건넬 수 있습니다. 그리고 셸의 이스케이프 규칙이야말로 돌아가는 명령을 기억으로 다시 세울 수 없게 만드는 부분입니다. 그것을 걷어내면 한 번의 시도가 남길 수 있는 것이 됩니다.

읽기 편한 응답

또 하나의 장점은 돌아오는 쪽입니다. 응답 머리와 본문이 자동으로 정리되고, JSON은 들여쓰기와 열이 맞으며, 상태 번호와 방식은 의미에 따라 색이 붙어 한눈에 문제 자리를 짚을 수 있습니다. 글자의 벽을 한 자씩 헤칠 필요가 없습니다.

3.x 계열은 응답에 걸린 시간 정보를 더했고, Pie 테마와 함께 쓰면 그 시간이 초록, 노랑, 주황, 빨강으로 바뀌어 느린 지점이 측정 도구를 열지 않고도 드러납니다. 나머지도 갖춰져 있습니다. 세션으로 로그인을 되풀이하지 않기, 한 명령으로 파일 올리기, Bearer와 Basic 인증의 기본 지원, 규약과 출력 형식을 넓힐 수 있는 확장 구조, 그리고 흘러오는 응답이 스스로 굴러가는 표시입니다.

열린 커뮤니티의 오랜 친구

프로젝트는 BSD-3-Clause 허가로 GitHub에 공개되어 별이 사만 개에 가깝고, 개발 도구 사이에서 오랜 고정 출연진입니다. 명령 줄 판은 3.2.4, 이것이 현재 판입니다. curl을 대신하려는 것이 아닙니다. 스크립트와 파이프 안에서는 curl이 여전히 왕이고 그 점은 당분간 바뀌지 않습니다. HTTPie가 겨냥하는 것은 사람 쪽으로, 창구 하나를 시험하는 비용을 가능한 한 0에 가깝게 만드는 일입니다.

공식으로 기계 화면용과 브라우저용 판도 있어, 터미널에 익숙하지 않은 팀원도 다른 도구가 아니라 같은 도구로 확인할 수 있고 결과를 팀 안에서 견줄 수 있습니다.

이 분담은 분명히 적을 값이 있습니다. 이런 도구를 둘러싼 논쟁은 대개 두 상황을 섞은 데서 나옵니다. 사람의 손을 떠나 돌아가야 하는 것은 스크립트에, curl에 속합니다. 사람이 직접 치고 읽고 고치는 것은 명령을 읽을 수 있게 지켜 주는 도구에 속하고, 바로 거기서 이 도구가 본전을 뽑습니다.

세션은 실제로 가장 많은 시간을 아끼는 부분입니다. 보호된 창구는 보통 무엇을 시험하기 전에 인증이 필요하고, 스무 번째 요청에서도 그것을 손으로 되풀이하면 사람은 창구를 생각하는 대신 한 번 쓰고 버릴 스크립트를 쓰기 시작합니다. 세션을 한곳에 두면 그 우회로가 사라집니다.

흘러오는 응답도 같은 이유로 쓸모가 있습니다. 사건을 계속 보내는 창구는 본문의 끝을 기다리는 도구로는 볼 수 없습니다. 생겨나는 대로 늘어서는 모습을 보는 것이 느린 서버와 멈춘 서버를 가르는 유일한 방법인 경우가 많습니다.

자주 언급되지 않는 이점도 하나 있습니다. 읽히는 명령은 되돌아보기를 가능하게 합니다. 문제가 생겼을 때 사흘 전에 내가 어떻게 호출했는지 확인하는 편이 처음부터 다시 짐작하는 것보다 훨씬 빠릅니다.

도구는 사람에게 맞춰야 하고 사람이 도구에 맞출 일은 아니라는 생각입니다. 같은 요청이 curl에서는 주문이 되고 여기서는 문장이 됩니다. 한 번 설치해 두면 창구를 살피는 속도와 기분이 함께 나아집니다.

HTTPie다운로드
지원 운영체제: Windows macOS Linux