curl 명령어 빌더
메서드·URL·헤더·본문으로 바로 실행할 수 있는 curl 명령어를 만듭니다. 값을 따옴표로 감싸고 이스케이프하므로 터미널에 그대로 붙여넣어도 안전합니다.
curl -X GET 'https://api.example.com/users' -H 'Content-Type: application/json'
요청 구성 요소를 curl 명령어로
curl 명령어 빌더는 HTTP 요청의 구성 요소를 복사해서 바로 실행할 수 있는 curl 명령어로 바꿔줍니다. GET이나 POST 같은 메서드를 고르고, 요청 URL을 입력하고, 헤더를 Key: Value 형식으로 한 줄에 하나씩 나열한 뒤 필요하면 요청 본문을 추가하세요. 명령어는 아래에 실시간으로 갱신되며, 메서드는 -X로(HEAD는 -I로), 각 헤더는 -H 플래그로, 본문이 있으면 --data로 표시됩니다. 모든 값은 작은따옴표로 감싸지고 값 안의 따옴표는 이스케이프되므로, 출력을 터미널에 그대로 붙여넣어도 안전합니다.
사용 방법
드롭다운에서 HTTP 메서드를 선택한 다음 호출할 전체 URL을 붙여넣으세요. 각 헤더는 Content-Type: application/json이나 Authorization: Bearer TOKEN처럼 한 줄에 하나씩 입력합니다. 데이터를 보낼 경우 본문 필드에 JSON, 폼 텍스트 등 원하는 내용을 입력하거나 붙여넣으세요. curl 명령어가 실시간으로 만들어지는 것을 확인한 뒤 복사 버튼을 눌러 터미널에서 실행하거나, 스크립트에 넣거나, 동료와 공유하세요.
자주 묻는 질문
따옴표와 특수 문자는 어떻게 처리되나요?
URL, 헤더, 본문의 각 값은 작은따옴표로 감싸지며, 값 안의 작은따옴표는 POSIX '\'' 방식으로 안전하게 이스케이프됩니다. 따라서 값에 공백, 앰퍼샌드(&), JSON이 포함되어 있어도 명령어를 셸에 그대로 붙여넣을 수 있습니다.
왜 GET인데도 -X GET이 표시되나요?
빌더는 명령어를 명확하고 수정하기 쉽게 하기 위해 -X로 메서드를 명시합니다. 단 HEAD만은 -I로 씁니다 — curl -X HEAD는 HEAD 응답에 오지 않는 본문을 기다리며 멈추기 때문입니다. curl은 GET을 기본값으로 처리하므로 -X GET은 생략한 것과 동일하게 동작합니다. 더 짧은 형태를 원하면 지워도 됩니다.
curl의 흔한 옵션과 기본 인증도 넣을 수 있나요?
네. 체크박스로 verbose, insecure, 헤더 포함, 오류 시 실패를 넣고, 연결 제한 시간과 저장할 파일 칸도 있습니다. 기본 인증 칸은 출력 언어마다 맞는 방식으로 자격 증명을 씁니다. fetch나 PowerShell 출력에 담을 수 없는 옵션은 빠졌다고 알려 줍니다.
프록시를 거쳐 요청을 보낼 수 있나요?
네. 프록시 (선택: curl -x, PowerShell -Proxy) 칸에 프록시 주소를 적으면 curl 출력에는 셸에 맞게 따옴표로 감싼 -x가, PowerShell 출력에는 PowerShell 방식으로 감싼 -Proxy가 붙습니다. fetch()에는 프록시 설정이 없어 JavaScript (fetch)를 고르면 프록시가 빠지고, 명령어 아래에 그렇다고 알려 줍니다. 프록시를 거치려면 curl이나 PowerShell로 바꾸세요.
curl은 어떻게 설치하나요?
macOS와 요즘 버전의 윈도우에는 이미 들어 있습니다. 윈도우 PowerShell에서는 curl이 Invoke-WebRequest의 다른 이름이라 curl.exe로 입력해야 하고, 출력 형식을 PowerShell로 고르면 이 페이지가 Invoke-RestMethod로 써 줍니다. 리눅스에서는 curl 패키지를 설치하세요. 예를 들어 sudo apt install curl이나 sudo dnf install curl입니다.
리디렉션을 따라가게 하려면 어떻게 하나요?
복사한 명령어에 -L(--location)을 덧붙이세요. 이 페이지에는 그 스위치가 없습니다. -L이 없으면 curl은 리디렉션 응답에서 멈추고 그 응답의 본문(대개 비어 있음)을 출력하며, 붙이면 Location 헤더에 적힌 주소로 이어서 요청합니다.
User-Agent는 어떻게 지정하나요?
헤더 칸에 User-Agent: my-script/1.0처럼 한 줄을 넣으면 명령어에 -H 'User-Agent: my-script/1.0'이 붙습니다. curl의 -A 옵션이 설정하는 것과 같은 헤더입니다. 넣지 않으면 curl은 자기 이름과 버전을 보냅니다.
응답 헤더는 어떻게 보나요?
응답 헤더 표시 (-i)를 켜면 curl이 본문 위에 상태 줄과 헤더를 출력합니다. 헤더만 보려면 메서드를 HEAD로 고르세요. 이 페이지는 이를 -I로 쓰고, -I는 본문 없이 헤더만 요청합니다.
자체 서명 인증서 허용 (-k)은 무엇을 하나요?
curl이 서버의 TLS 인증서를 아예 검사하지 않게 해서, 위조된 인증서까지 어떤 인증서든 받아들입니다. 자체 서명 인증서를 쓰는 테스트 서버에만 쓰고, 실제 사이트나 비밀번호·토큰을 담은 요청에는 쓰지 마세요.
명령어를 스크립트 파일로 저장할 수 있나요?
네. 다운로드는 출력 형식에 맞는 이름의 파일로 명령어를 저장합니다 — curl은 curl-builder.sh, JavaScript (fetch)는 curl-builder.js, PowerShell은 curl-builder.ps1입니다. 바로 실행하거나 프로젝트에 넣으면 되고, 복사는 같은 내용을 클립보드에 담습니다.