cURL 명령 빌더

사용 방법

1. 1

   메서드를 고르고 URL 입력

   GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS 중에서 고르고 전체 URL을 입력하거나, POST JSON, Bearer 토큰, 폼 로그인 같은 예제에서 시작합니다. URL은 필수이며 입력한 그대로 사용합니다. URL에 대괄호나 중괄호가 있으면 curl의 URL 글로빙을 끄는 -g를 자동으로 추가합니다.

2. 2

   헤더를 한 줄에 하나씩 추가

   각 헤더를 Name: value 형식(예: Content-Type: application/json)으로 쓰거나 자주 쓰는 헤더는 빠른 버튼으로 추가합니다. 줄 앞뒤 공백은 잘리고 빈 줄은 무시됩니다. 올바른 헤더 이름 뒤에 콜론이 없는 줄은 메시지와 함께 거부됩니다.

3. 3

   본문 붙여 넣기

   JSON 문서나 폼 데이터 같은 요청 본문을 텍스트로 입력합니다. 본문이 비어 있으면 데이터 옵션이 추가되지 않습니다. Content-Type 헤더가 JSON인데 본문이 해석되지 않으면 경고가 나옵니다. HEAD가 아닌 요청에 본문이 있고 Content-Type이 없으면 curl의 기본값 application/x-www-form-urlencoded를 알리는 경고가 나옵니다. 실제 본문 형식에 맞는 헤더를 추가하세요.

4. 4

   옵션 설정

   리디렉션 따라가기는 -L을 추가합니다. POST에서는 301·302·303 리디렉션에서도 POST를 유지하는 스위치가 나타납니다. 압축 응답 요청, 자세한 출력(-v)을 켜고, 플래그마다 줄을 나눌지 한 줄로 쓸지도 고를 수 있습니다.

5. 5

   읽은 뒤 복사

   설명 목록과 경고를 보며 명령을 확인한 뒤 버튼이나 Ctrl/Cmd + Enter로 복사하세요. 티켓이나 채팅에 붙여 넣기 전에 실제 토큰은 지우세요.

작동 원리

curl \
  'https://api.example.com/v1/events' \
  -H 'Authorization: Bearer replace-me' \
  -H 'Content-Type: application/json' \
  --data-raw '{"event":"deploy","dry_run":true}' \
  -L

실제 예시

메서드: POST
URL: https://api.example.com/v1/events
헤더:
Authorization: Bearer replace-me
Content-Type: application/json
요청 본문: {"event":"deploy","dry_run":true}
리디렉션 따라가기 (-L): 켬

curl \
  'https://api.example.com/v1/events' \
  -H 'Authorization: Bearer replace-me' \
  -H 'Content-Type: application/json' \
  --data-raw '{"event":"deploy","dry_run":true}' \
  -L

메서드: GET
URL: https://example.com
헤더: X-Test: it's fine

curl 'https://example.com' -H 'X-Test: it'\''s fine'

메서드: PUT
URL: https://example.com/items/7
헤더: Content-Type: application/json
요청 본문: {"name":"O'Reilly"}
자세히 출력 (-v): 켬

curl -X PUT 'https://example.com/items/7' -H 'Content-Type: application/json' --data-raw '{"name":"O'\''Reilly"}' -v

메서드: HEAD
URL: https://example.com/
리디렉션 따라가기 (-L): 켬

curl -I 'https://example.com/' -L

메서드: POST
URL: https://example.com/login
헤더: Content-Type: application/x-www-form-urlencoded
요청 본문: user=ada&password=secret
리디렉션 따라가기 (-L): 켬
리디렉션에서 POST 유지: 켬

curl 'https://example.com/login' -H 'Content-Type: application/x-www-form-urlencoded' --data-raw 'user=ada&password=secret' -L --post301 --post302 --post303

헤더: broken

헤더는 Accept: application/json처럼 Name: value 형식으로 써 주세요.

자주 하는 실수

• -X HEAD 사용

  cURL 매뉴얼은 -X로 HEAD를 강제하면 오지 않는 본문을 curl이 기다린다고 경고합니다. 빌더는 HEAD에 -I를 쓰니, 명령을 손으로 고칠 때도 그대로 두세요.

• 리디렉션 뒤 POST가 GET으로 바뀜

  301, 302, 303 뒤에 curl은 브라우저처럼 본문 없이 GET으로 요청을 반복합니다. 서버가 POST를 리디렉션하는데(예: 로그인 뒤 /home으로 보냄) POST를 반복해야 한다면 -X로 메서드를 강제하지 말고 "리디렉션에서 POST 유지"를 켜세요.

• JSON인데 Content-Type을 빼먹음

  Content-Type: application/json이 없는 JSON 본문은 폼 데이터로 전송되어 많은 API가 400이나 415로 응답합니다. 빠른 버튼으로 헤더를 추가하세요. 빌더는 HEAD가 아닌 요청의 본문에 Content-Type이 없으면 경고합니다. 내용이 JSON처럼 보여도 기본 헤더는 application/x-www-form-urlencoded입니다.

• 공유하는 명령에 비밀을 붙여 넣음

  복사한 명령에는 Authorization 헤더가 평문으로 들어 있습니다. 올리기 전에 실제 토큰을 자리 표시자로 바꾸고, 셸 기록에는 실행한 모든 것이 남는다는 점도 기억하세요.

• POSIX 명령을 cmd.exe에서 실행

  Windows cmd.exe는 작은따옴표를 따옴표로 취급하지 않아 명령이 깨집니다. Git Bash나 WSL을 쓰거나 셸에 맞게 따옴표를 고쳐 쓰세요.

• URL의 공백과 특수 문자

  URL은 입력한 그대로 사용합니다. 공백이나 쿼리 값은 직접 퍼센트 인코딩(%20)하거나, 복사한 명령에 -G --data-urlencode를 써서 인코딩한 데이터를 GET 쿼리로 붙이세요. -G 없이 --data-urlencode만 쓰면 요청 본문으로 보냅니다. 괄호가 있으면 -g가 자동으로 붙지만, 글로빙만 끌 뿐 URL을 인코딩하지는 않습니다.

자주 묻는 질문