<div id="readability-page-1" class="page"><div id="post-content" itemprop="articleBody"><p>네트웍 요청을 다룰 때 주로 cURL이나 포스트맨을 사용한다. 비교적 간편한 전자를 기본으로 쓰면서 팀에서 협업할 때는 후자를 이용하는 편이다.</p>
<p>1998년에 출시한 이 도구는 벌써 20년이 지났다. 아직도 많은 개발자들이 손에서 놓치 않는 비결은 뭘까? 주요 구조를 알아보고 내가 사용하는 사례 몇 가지를 정리해 보겠다.</p>
<h2 id="구조"><a href="#%EA%B5%AC%EC%A1%B0" aria-label="구조 permalink"></a>구조</h2>
<p>이름은 'URL을 위한 클라이언트'라는 뜻이다.</p>
<blockquote>
<p>client for URLs.</p>
</blockquote>
<p>보통 curl이라고 소문자를 사용해 불렀는데, 공식 홈페이지에는 URL을 대문자로 강조했다. '클라이언트 전용 URL 요청 처리기' 정도로 이해하면 되겠다.</p>
<p>libcurl이란 라이브러리가 핵심이다. HTTP를 포함한 각종 인터넷 프로토콜을 지원하고 HTTPS, 파일 업로드, 프록시, 쿠키, 인증 등을 제공한다. 여러 운영체제를 지원해 이식성도 뛰어난 편이다.</p>
<p>C 언어로 작성했는데 다양한 프로그래밍 언어에서 사용할수 있게 바인딩한 라이브러리를 제공한다. 자바스크립트로 코딩하고 싶다면 <a href="https://github.com/JCMais/node-libcurl">node-libcurl</a>을 노드 환경에서 사용할 수 있다. <a href="https://github.com/JCMais/node-libcurl/tree/develop/benchmark">벤치마크 문서</a>에 따르면 여타 HTTP 라이브러리 중 가장 빠른 속도를 자랑한다고 한다.</p>
<p>라이브러리 형태로 제공한 libcurl을 커맨드 라인 환경에서 사용할수 있게 만든 도구가 바로 cURL이다.</p>
<p>그럼 몇 가지 사용법을 알아보자.</p>
<h2 id="파일-요청"><a href="#%ED%8C%8C%EC%9D%BC-%EC%9A%94%EC%B2%AD" aria-label="파일 요청 permalink"></a>파일 요청</h2>
<p>인자로 전달한 URL로 HTTP 요청을 보내고 응답을 받을 수 있다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org

&lt;!DOCTYPE html&gt;
&lt;html lang="en"&gt;
// ...</code></pre></div>
<p>글을 작성하면서 httpbin.org라는 서비스를 발견했는데 HTTP 요청 테스트하기에 좋다.</p>
<ul>
<li>이 도메인으로 요청을 보내면 html 파일을 본문에 담아 응답하는데 터미널에 이 문서 코드가 출력 되었다.</li>
</ul>
<p>브라우져는 이 응답을 받으면 헤더와 함께 읽고 문서를 렌더링할 것이다.</p>
<p>헤더를 포함해 좀 더 많은 정보를 보려면 --verbose, -v 옵션을 사용한다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org --verbose

- Trying 34.235.39.169:443...
- Connected to httpbin.org (34.235.39.169) port 443 (#0)
  ...
- (304) (OUT), TLS handshake, Client hello (1):
  (304) (IN), TLS handshake, Server hello (2):
  ...
- TLSv1.2 (IN), TLS handshake, Finished (20):
  ...
  &gt; GET / HTTP/2
  &gt; Host: httpbin.org
  &gt; User-Agent: curl/8.1.2
  &gt; Accept: _/_
  &gt;
  &gt; &lt; HTTP/2 200
  &gt; &lt; date: Sat, 02 Dec 2023 04:21:19 GMT
  &gt; &lt; content-type: text/html; charset=utf-8
  &gt; &lt; content-length: 9593
  &gt; &lt; server: gunicorn/19.9.0
  &gt; &lt; access-control-allow-origin: \*
  &gt; &lt; access-control-allow-credentials: true
  &gt; &lt;
  &lt;!DOCTYPE html&gt;
  &lt;html lang="en"&gt;</code></pre></div>
<ul>
<li>해당 도메인에 해당하는 아이피 주소로 요청을 보낸다. DSN 서버에서 질의해서 얻은 주소일 것이다.</li>
<li>HTTPS이기 때문에 443 포트를 사용했다.</li>
<li>서버를 찾아 연결된 후에는 핸드쉐이크 과정을 거친다.</li>
<li>HTTP 헤더에 정보를 담아 요청을 보낸다.</li>
<li>서버는 HTTP 헤더에 정보를 담고 본문에 파일 내용을 담아 응답한다.</li>
</ul>
<h2 id="http-api-요청"><a href="#http-api-%EC%9A%94%EC%B2%AD" aria-label="http api 요청 permalink"></a>HTTP API 요청</h2>
<p>cURL을 사용할 때 아무런 옵션을 지정하지 않으면 GET 메소드가 기본이다. REST API는 POST, PUT, DELETE 을 요청힐 수 있는데 cURL에서는 어떻게 할까?</p>
<p>--data, -d 옵션을 사용해 요청 본문을 전달하면 POST 메소드를 요청할 수 있다.</p>
<div data-language="text"><pre><code>curl --data "foo=bar" https://httpbin.org/post

{
 "form": {
    "foo": "bar"
...</code></pre></div>
<ul>
<li>서버 로직에 따라 전달한 인자를 다시 본문에 담아 응답했다.</li>
</ul>
<p>PUT과 DELETE 같은 추가 메소드는 --request, -X 옵션을 사용한다.</p>
<div data-language="text"><pre><code>curl --request "PUT" --data "foo=bar" https://httpbin.org/put

curl --request "DELETE" https://httpbin.org/delete</code></pre></div>
<p>API 응답은 보통 json 형식을 많이 사용한다. 한 줄로 된 응답 값을 사용할수 도 있지만 내용이 길면 들여쓰기 해야 읽기 편한다. JSON 처리기인 <a href="https://jqlang.github.io/jq/">jq</a>와 함께 사용해 보자.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/get | jq</code></pre></div>
<p>좀 더 깔끔하게 보려면 --silent, -s 옵션을 사용한다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/get --silent | jq

{
  "args": {},
  "headers": {
...</code></pre></div>
<p>응답값을 파일로 저장하려면 --output, -o 옵션을 사용한다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/get --output result.txt
cat result.txt
{
  "args": {},
  "headers": {
...</code></pre></div>
<h2 id="캐시-동작-확인"><a href="#%EC%BA%90%EC%8B%9C-%EB%8F%99%EC%9E%91-%ED%99%95%EC%9D%B8" aria-label="캐시 동작 확인 permalink"></a>캐시 동작 확인</h2>
<p>헤더 요청만 보내고 싶은 경우가 있다. -X HEAD 로 보내면 될것 같지만 그렇지가 않다. 전용 옵션인 --head, -I 를 사용해야 한다. 주로 캐시관련 헤더 확인 시 사용하는 편이다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/ --head

HTTP/2 200
date: Fri, 01 Dec 2023 23:21:11 GMT
content-type: text/html; charset=utf-8
content-length: 9593
server: gunicorn/19.9.0
access-control-allow-origin: *
access-control-allow-credentials: true</code></pre></div>
<ul>
<li>문서 타입과 길이를 확인한다.</li>
<li>서버 이름을 봐서 파이썬을 사용한듯 하다.</li>
<li>cors 관련 헤더도 있다.</li>
</ul>
<p>깃헙 페이지를 사용한 이 블로그는 어떤 헤더를 사용할까?</p>
<div data-language="text"><pre><code>curl https://jeonghwan-kim.github.io/ --head

HTTP/2 200
content-type: text/html; charset=utf-8
permissions-policy: interest-cohort=()
last-modified: Thu, 16 Nov 2023 09:14:08 GMT
etag: "6555dd60-12ac2"
expires: Thu, 16 Nov 2023 10:11:36 GMT
cache-control: max-age=600
x-proxy-cache: MISS
x-served-by: cache-icn1450067-ICN
x-cache: HIT
x-cache-hits: 1</code></pre></div>
<ul>
<li>etag, cache-control 등의 기본 캐시 관련 헤더를 사용한다.</li>
<li>깃헙에서 확장해 사용한 x-* 헤더도 있다.</li>
</ul>
<h2 id="리다이렉션-동작-확인"><a href="#%EB%A6%AC%EB%8B%A4%EC%9D%B4%EB%A0%89%EC%85%98-%EB%8F%99%EC%9E%91-%ED%99%95%EC%9D%B8" aria-label="리다이렉션 동작 확인 permalink"></a>리다이렉션 동작 확인</h2>
<p>리다이렉션 요청을 보내보자.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/redirect/1 --head

HTTP/2 302
location: /get
...</code></pre></div>
<ul>
<li>리다이렉션을 의미하는 302 상태 코드를 응답했다.</li>
<li>이동할 경로를 location 헤더에 담아 보냈다.</li>
<li>브라우져는 이 헤더를 읽고 다시 GET /get 요청을 보낼 것이다.</li>
</ul>
<p>cURL에서도 브라우져와 같이 리다이렉션 응답을 받으면 다시 요청하는 동작을 할 수 있다. --location, -L 옵션을 사용한다.</p>
<div data-language="text"><pre><code>curl https://httpbin.org/redirect/1 -head --location

HTTP/2 302
location: /get
...

HTTP/2 200
content-type: application/json
content-length: 254
...</code></pre></div>
<h2 id="사용법-익히기"><a href="#%EC%82%AC%EC%9A%A9%EB%B2%95-%EC%9D%B5%ED%9E%88%EA%B8%B0" aria-label="사용법 익히기 permalink"></a>사용법 익히기</h2>
<p>이러한 기본적인 사용법만으로도 이 도구를 사용하는데 불편함은 없을 것이다. 다만 특별한 경우에는 설명서를 참고해야하는데 맨 페이지를 사용한다.</p>

<p>좀 익숙하지 않지만 읽을만 하다. 인터넷 검색 결과와 함께 보는 편이다.</p>
<p>브라우져를 활용하면 더 많은 사용법을 익힐 수 있다. 브라우져 네트워크 탭에는 페이지에서 발생한 요청 목록이 있는데 이 중 하나의 요청을 선택한 뒤 컨택스트 메뉴로 cURL 명령어를 복사할 수 있다.</p>
<figure>
    <span>
      <a href="/static/39640dd090b4ebed99a7f9b7112aa125/7e7db/firefox-curl.jpg" target="_blank" rel="noopener">
    <span></span>
  <img alt="파이어폭스 cURL 명령어로 바꿔 복사" title="파이어폭스 cURL 명령어로 바꿔 복사" src="https://jeonghwan-kim.github.io/static/39640dd090b4ebed99a7f9b7112aa125/fee13/firefox-curl.jpg" sizes="(max-width: 726px) 100vw, 726px" loading="lazy" decoding="async">
  </a>
    </span>
    <figcaption>파이어폭스 cURL 명령어로 바꿔 복사</figcaption>
  </figure>
<div data-language="text"><pre><code>curl 'https://httpbin.org/#/' \
-X 'GET' \
-H 'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8' \
-H 'Sec-Fetch-Site: none' \
-H 'Accept-Encoding: gzip, deflate, br' \
-H 'Sec-Fetch-Mode: navigate' \
-H 'Host: httpbin.org' \
-H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.1 Safari/605.1.15' \
-H 'Accept-Language: ko-KR,ko;q=0.9' \
-H 'Sec-Fetch-Dest: document' \
-H 'Connection: keep-alive'</code></pre></div>
<ul>
<li>cURL과 다르게 브라우져는 URL로 요청을 보낼 때 더 많은 헤더를 전달한다.</li>
<li>메소드, 컨텐츠 협상, 압축 방식, 유저 에이전트, 언어셋.</li>
</ul>
<p>브라우져가 제공한 cURL 명령어 옵션을 통해 HTTP와 브라우저의 동작을 더 이해할 수 있을 것이다.</p>
<h2 id="결론"><a href="#%EA%B2%B0%EB%A1%A0" aria-label="결론 permalink"></a>결론</h2>
<p>동료가 cURL을 사용하는 걸보고 처음 이 도구를 알았다. 당시 나는 포스트맨이나 에디터에 내장된 HTTP 요청 툴을 사용했는데 유저 인터페이스, 요청 저장 등 부가기능이 편하기 때문이다.</p>
<p>cURL을 조금씩 사용해보니 도구의 담백함이 오히려 좋았다. 튜닝 끝은 순정인 것 처럼 본질에 충실한 것이 오래 가는 법이다.</p>
<h2 id="참고"><a href="#%EC%B0%B8%EA%B3%A0" aria-label="참고 permalink"></a>참고</h2>
<ul>
<li><a href="https://curl.se/">https://curl.se/</a></li>
<li>[What is cURL](FAQ -- Frequently Asked Questions)</li>
<li><a href="https://httpbin.org/">https://httpbin.org/</a></li>
<li><a href="https://jqlang.github.io/jq/">https://jqlang.github.io/jq/</a></li>
</ul></div></div>

김정환 블로그 RSS Feed

김정환

네트웍 요청을 다룰 때 주로 cURL이나 포스트맨을 사용한다. 비교적 간편한 전자를 기본으로 쓰면서 팀에서 협업할 때는 후자를 이용하는 편이다. 1998년에 출시한 이 도구는 벌써 2…

cURL

댓글