HTTPie 시작하기

자체 API를 구축하든 타사 서비스를 사용하든 관계없이 해당 API와 안정적으로 통신할 수 있는지 확인하는 것이 좋습니다.

HTTPie는 명령줄에서 직접 API와 쉽게 통신할 수 있는 가볍지만 강력한 오픈 소스 HTTP 클라이언트입니다.



개발자는 HTTPie를 사용하여 다양한 API 엔드포인트를 테스트, 디버깅 및 탐색하여 주어진 조건에서 어떻게 작동하는지 확인합니다. HTTPie는 색상화된 출력, 간단한 구문 및 탐색을 쉽게 만들어주는 여러 기능과 함께 제공됩니다!

이 가이드는 HTTPie의 기본 사용법을 다루고 시작하는 데 도움이 되는 몇 가지 예를 제공합니다. ✨

1단계: HTTPie 설치

최신 버전의 HTTPie를 설치하는 가장 좋은 방법은 pip, the Python package installer 을 사용하는 것입니다.

# Make sure we have an up-to-date version of pip and setuptools:
$ python -m pip install --upgrade pip setuptools
$ python -m pip install --upgrade httpie

macOS에서는 brew install httpie 를 실행하여 Homebrew를 사용할 수도 있습니다.

HTTPie는 GitHub에서 제공되는 소스 코드를 직접 사용하여 설치할 수도 있습니다.

HTTPie에는 http 및 https 의 두 가지 명령이 있습니다. 설치가 완료되면 다음을 실행하여 설치되었는지 확인하십시오.

$ http --version
$ https --version

둘 다 동일한 버전을 반환하는지 확인하십시오. HTTPie 설치에 문제가 있는 경우 언제든지 HTTPie Discord 커뮤니티에 문의할 수 있습니다!

2단계: 첫 번째 요청하기 🥇

설치가 완료되었습니까? 잘했어요! 이제 다양한 API를 살펴보고 탐색할 수 있는 단계에 한 걸음 더 가까워졌습니다.

Hello World 요청하기:

# The server should say hello back to you!
$ https httpie.io/hello

요청 매개변수를 지정하지 않으면(예: 일부 JSON, 잠시 후에 설명하겠습니다!) HTTPie는 HTTPGET method를 암시적으로 사용합니다.

따라서 위의 예는 다음과 동일합니다.

$ https GET httpie.io/hello

3단계: HTTPie로 다양한 HTTP 요청 보내기

즉, HTTPie 명령은 다음 형식을 사용합니다.

$ http [flags] [METHOD] URL [ITEM [ITEM]]

여기서 flags는 HTTPie 동작 매개변수이고, METHOD는 HTTP 메서드이고, URL는 웹페이지 또는 API URL이고, ITEM는 querystring parameters, request data and/or headers입니다.

사용 가능한 모든 플래그 옵션을 보려면 http --help를 실행하거나 docs을 참조하십시오.

HTTP 대 HTTPS

HTTPie에는 http 및 https 명령이 미리 설치되어 있어 HTTP 및 HTTPS 요청을 처리할 수 있습니다.

위의 예에서 https를 사용하여 httpie.io/hello를 쿼리해야 함을 나타내는 줄임말로 https://httpie.io/hello에 요청합니다.

다음도 완벽하게 유효합니다.

$ http https://httpie.io/hello

HTTP 메소드

[METHOD]는 선택적 HTTPie 매개변수입니다. 명령에 요청 데이터를 지정하지 않으면 GET가 기본적으로 사용된다는 것을 이미 알고 있습니다. 입력할 필요가 없습니다.

# Get the top GitHub search result for search term "httpie"
$ https api.github.com/search/repositories?q=httpie&per_page=1

하지만 기다려! 위의 내용을 단순화할 수 있습니다. 😏

쿼리 문자열 매개변수를 추가하려는 경우(참고: 쿼리 문자열 매개변수는 URL에 JSON 데이터가 아니라 ?param1=value1&param2=value2 로 표시되는 매개변수임), == 속기를 사용합니다.

# Get the top GitHub search result for search term "httpie"
$ https api.github.com/search/repositories q==httpie per_page==1

일부 요청 데이터를 지정하면 HTTPie는 기본적으로 HTTP POST method을 사용합니다.
GET , POST , PUT , DELETE , PATCH 등의 명령에 지정하여 필요한 HTTP 메서드를 수동으로 설정할 수 있습니다.

데이터

일부 쿼리 문자열 매개 변수를 사용하여 요청하려면 위 섹션에 설명된 구문을 사용하세요.
http 또는 https 명령에서 HTTPie의 단축 구문을 사용하여 JSON에서 요청 매개변수를 지정할 수 있습니다.
=는 문자열 값용, :=는 원시 JSON용, :=@는 JSON 파일용, =@는 일반 파일용입니다.

$ http PUT pie.dev/put \
    name=John \                        # String (default)
    age:=29 \                          # Raw JSON — Number
    married:=false \                   # Raw JSON — Boolean
    hobbies:='["http", "pies"]' \      # Raw JSON — Array
    favorite:='{"tool": "HTTPie"}' \   # Raw JSON — Object
    bookmarks:=@files/data.json \      # Embed JSON file
    description=@files/text.txt        # Embed text file

HTTPie를 사용하면 데이터를 양식 데이터로 제출할 수도 있습니다. 자세한 방법은 docs on forms을 참조하십시오.

헤더

기본적으로 HTTPie는 요청에 다음 헤더를 추가합니다.

GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
User-Agent: HTTPie/<version>
Host: <taken-from-URL>

이러한 헤더를 재정의하거나 직접 설정할 수 있습니다. 다음과 같이 Header:Value 표기법을 사용하십시오.

$ http pie.dev/headers 'Custom-Header-Name:Custom Header Value'

쿠키 및 인증 헤더를 보내는 방법 또는 응답 헤더로 작업하는 방법에 대한 자세한 내용은 docs 을 참조하십시오.


HTTPie에 대해 궁금한 점이 있으면 HTTPie Discord 또는 .

오늘은 여기까지입니다. 행복한 해킹!