curl은 다양한 네트워크 프로토콜을 사용하여 데이터를 전송하는 명령줄 도구입니다. 모든 주요 운영 체제에서 사용할 수 있는 curl은 명령줄에서 HTTP 요청을 보내는 표준 도구로 자리 잡았습니다.
curl의 크로스 플랫폼 유틸리티는 HTTP, HTTPS, FTP, IMAP 등의 프로토콜을 지원하여 API 요청 전송 및 웹사이트 스크래핑을 쉽게 수행할 수 있게 합니다. 광범위한 가용성과 다중 프로토콜 지원 덕분에 REST API 문서에서 명령줄에서 직접 API 호출을 테스트하는 빠른 방법으로 curl이 자주 언급됩니다:
이 글에서는 명령줄에서 curl을 사용하여 POST 요청을 보내는 방법을 배웁니다.
POST 요청이란?
POST 요청은 서버에 데이터를 전송하는 HTTP 메서드로, 가장 흔히 사용되는 HTTP 메서드 중 하나입니다.
POST 요청을 보낼 때 전송되는 데이터는 요청 본문에 포함됩니다. 이는 URL에 데이터를 포함시키는 GET 요청 방식보다 더 은밀하게 데이터를 전송할 수 있게 합니다. 또한 POST 요청에서는 훨씬 더 많은 데이터를 보낼 수 있어, 브라우저가 GET 요청에 적용하는 URL 길이 제한을 우회할 수 있습니다.
POST 요청은 주로 양식 제출, 파일 업로드 또는 API에 JSON 데이터 전송에 사용됩니다. GET과 비교하여 POST 요청은 일반적으로 캐시되지 않으며, 요청 데이터가 요청 본문에 포함되기 때문에 브라우저 기록에 표시되지 않습니다.
curl을 사용한 POST 요청 전송 방법
이 튜토리얼을 시작하기 전에 컴퓨터에 curl을 설치해야 합니다. curl이 설치되었는지 확인하려면 다음 명령어를 실행하세요:
curl --version
명령을 찾을 수 없다는 오류가 발생하면 유틸리티를 설치해야 합니다.
curl 설치
주요 운영 체제별 curl 설치 방법은 다음과 같습니다:
Windows
Windows에서는 Windows 11의 기본 패키지 관리자 WinGet을 사용하여 curl을 설치할 수 있습니다:
winget install curl.curl
Chocolatey는 Windows용 또 다른 패키지 관리자로, 다음 명령어로 curl을 설치할 수 있습니다:
choco install curl
Linux
대부분의 Linux 패키지 관리자에서 curl을 사용할 수 있습니다. Ubuntu/Debian에서는 다음 명령어로 curl을 설치하세요:
apt-get install curl
Red Hat Enterprise Linux(RHEL), CentOS, Fedora에서는 Yellowdog Updater Modified(YUM)를 사용하여 다음과 같이 curl을 설치할 수 있습니다:
yum install curl
OpenSUSE를 사용 중이라면 다음 터미널 명령어로 curl을 설치할 수 있습니다:
zypper install curl
마지막으로 Arch Linux에서는 pacman을 사용하여 다음과 같은 명령어로 curl을 설치할 수 있습니다:
pacman -Sy curl
macOS
macOS에서 curl을 설치하는 가장 쉬운 방법은 Homebrew를 이용하는 것입니다. Homebrew가 설치되어 있는지 확인한 후 다음 명령어를 실행하세요:
brew install curl
이제 운영 체제에 curl을 설치했으므로 POST 요청을 만드는 방법을 배울 준비가 되었습니다.
POST 요청 수행하기
POST 요청을 보낼 때 curl을 사용하면 여러 옵션을 지정할 수 있습니다. 다음 섹션에서는 이 유틸리티를 사용하여 POST 요청을 수행할 때 접할 수 있는 몇 가지 일반적인 curl 기능을 보여줍니다.
POST 메서드 지정
curl을 사용하여 HTTP 요청을 할 때는 수행할 HTTP 메서드를 지정해야 합니다. HTTP 메서드에는 GET, POST, PUT, DELETE가 있습니다. curl은 -X 명령줄 플래그를 사용하여 사용하려는 HTTP 메서드를 지정할 수 있게 합니다.
예를 들어, https://httpbin.org/anything로 POST 요청을 보내려면 터미널에서 다음 curl 명령을 실행할 수 있습니다:
curl -X POST https://httpbin.org/anything
httpbin.org는 응답에 요청 본문과 헤더를 반환합니다. 응답은 다음과 같아야 합니다:
{
"args": {},
"data": "",
"files": {},
"form": {},
"headers": {
"Accept": "*/*",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": null,
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
-X POST 플래그는 --request POST 플래그 사용과 동일하므로, 다음 명령을 실행해도 동일한 결과를 얻을 수 있습니다:
curl --request POST https://httpbin.org/anything
응답은 이전과 동일하게 보입니다.
-X 및 --request 플래그에 대한 자세한 내용은 공식 문서에서 확인할 수 있습니다.
Content-Type 설정
POST 요청을 보낼 때는 서버가 요청 본문을 올바르게 해석할 수 있도록 본문에 포함된 콘텐츠의 유형을 명시하는 것이 중요합니다. HTTP 요청의 Content-Type 헤더에 MIME 유형을 사용하여 요청 본문 형식을 지정할 수 있습니다.
예를 들어, 요청 본문에 JSON을 전송하는 경우 Content-Type 헤더를 application/json으로 설정하여 웹 서버가 JSON 콘텐츠를 예상하도록 알려야 합니다. XML을 전송하는 경우 Content-Type 헤더는 application/xml이어야 합니다. 자세한 내용은 Content-Type에 대해 설명하는 공식 문서를 참조하세요.
curl은 -H 플래그를 사용하여 HTTP 요청에 대한 헤더를 지정할 수 있게 합니다. 예를 들어, POST 요청으로 JSON을 전송하는 경우 다음 curl 명령은 요청에 대한 Content-Type 헤더를 설정하는 방법을 보여줍니다:
curl -X POST -H 'Content-Type: application/json' -d '{}' https://httpbin.org/anything
응답에서 Content-Type 헤더가 application/json으로 설정된 것을 확인할 수 있습니다:
{
"args": {},
"data": "{}",
"files": {},
"form": {},
"headers": {
"Accept": "*/*",
"Content-Length": "2",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=-11111111-111111111111111111111111"
},
"json": {},
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
-H 플래그는 더 긴 --header 플래그를 사용하여 지정할 수도 있습니다. 이 경우 curl 명령어는 다음과 같이 보일 것입니다:
curl -X POST --header 'Content-Type: application/json' -d '{}' https://httpbin.org/anything
응답은 이전과 동일하게 표시됩니다.
데이터 전송
이전 명령어에 -d 플래그가 포함된 것을 눈치채셨을 것입니다. 이 플래그는 요청 본문에 전송할 데이터를 지정할 수 있게 합니다. 따옴표로 묶인 값 문자열을 전달하는 데 사용할 수 있습니다. 예를 들어:
curl -X POST -H 'Content-Type: application/json' -d '{
"FirstName": "Joe",
"LastName": "Soap"
}' https://httpbin.org/anything
httpbin.org가 응답의 data 속성에 전송한 본체 데이터를 표시하는 것을 확인할 수 있습니다.
curl이 본문에 전송할 데이터가 담긴 파일이 있다면, 파일 이름 앞에 @ 문자를 붙여 지정하세요. 다음 명령어는 body.json의 내용을 읽고 요청 본문을 통해 전송합니다:
curl -X POST -H 'Content-Type: application/json' -d @body.json https://httpbin.org/anything
이 경우 body.json 파일에는 다음과 같은 내용이 포함됩니다:
{
"FirstName": "Joe",
"LastName": "Soap"
}
이를 전송하면 httpbin.org는 다음과 같은 응답을 반환해야 합니다:
{
"args": {},
"data": "{t"FirstName": "Joe",t"LastName": "Soap"}",
"files": {},
"form": {},
"headers": {
"Accept": "*/*",
"Content-Length": "41",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": {
"FirstName": "Joe",
"LastName": "Soap"
},
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
--data 플래그는 -d와 동일하게 동작하므로 서로 바꿔서 사용할 수 있습니다.
JSON 데이터 전송
이전 섹션에서는 Content-Type 헤더를 application/json으로 설정하고 -d 플래그를 사용하여 JSON 데이터를 전달하는 방법을 살펴보았습니다. 요청을 보낼 때 응답으로 어떤 형식의 데이터를 기대하는지 웹 서버에 알리는 것도 중요합니다. Accept 헤더에 application/json 값을 사용하여 웹 서버에 JSON 응답을 수신하고 싶다는 것을 알릴 수 있습니다.
다음 명령어는 서버에 JSON 요청을 전송하고 응답으로 JSON을 수신할 의사가 있음을 알립니다:
curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
"FirstName": "Joe",
"LastName": "Soap"
}' https://httpbin.org/anything
응답 본문의 data 및 json 속성에 요청에서 보낸 JSON 데이터가 포함된 것을 확인할 수 있습니다:
{
"args": {},
"data": "{n "FirstName": "Joe",n "LastName": "Soap"n}",
"files": {},
"form": {},
"headers": {
"Accept": "application/json",
"Content-Length": "50",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": {
"FirstName": "Joe",
"LastName": "Soap"
},
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
HTTP 요청을 보낼 때 JSON 데이터 송수신은 흔한 작업입니다. 따라서 curl은 --json 플래그를 제공하여 Content-Type 및 Accept 헤더를 설정하고 요청 본문에 JSON 데이터를 포함시켜 보냅니다. 이 플래그를 사용하면 POST 요청에서 JSON을 전송하는 명령어를 간소화할 수 있습니다:
curl -X POST --json '{
"FirstName": "Joe",
"LastName": "Soap"
}' https://httpbin.org/anything
이는 이전과 동일한 응답을 반환합니다:
{
"args": {},
"data": "{n "FirstName": "Joe",n "LastName": "Soap"n}",
"files": {},
"form": {},
"headers": {
"Accept": "application/json",
"Content-Length": "50",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": {
"FirstName": "Joe",
"LastName": "Soap"
},
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
--json 플래그는 2022년 3월 curl 버전 7.82에서 출시되었으므로, 사용하기 전에 최신 버전의 curl이 설치되어 있는지 확인하십시오.
XML 데이터 전송
curl은 XML과 같은 다른 형식의 데이터도 전송할 수 있습니다. XML 데이터를 전송하려면 Content-Type 헤더를 application/xml로 설정하고 -d 플래그를 사용하여 요청 본문에 XML 데이터를 전달해야 합니다. 또한 Accept 헤더를 application/xml로 설정하여 웹 서버에 응답이 XML 형식이어야 함을 알릴 수도 있습니다.
다음 명령어는 curl을 사용하여 POST 요청으로 XML 객체를 전송하는 방법을 보여줍니다:
curl -X POST -H 'Content-Type: application/xml' -H 'Accept: application/xml' -d '<Person>
<FirstName>Joe</FirstName>
<LastName>Soap</LastName>
</Person>' https://httpbin.org/anything
httpbin.org에서 반환된 data 속성에서 XML 요청 데이터를 확인할 수 있습니다:
{
"args": {},
"data": "<Person>n <FirstName>Joe</FirstName>n <LastName>Soap</LastName>n</Person>",
"files": {},
"form": {},
"headers": {
"Accept": "application/xml",
"Content-Length": "79",
"Content-Type": "application/xml",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": null,
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
FormData 전송
FormData를 사용하여 키-값 쌍의 데이터를 웹 서버로 전송할 수 있습니다. 이름에서 알 수 있듯이, 이 데이터 형식은 웹 페이지에서 양식을 제출할 때 사용합니다. 키-값 쌍은 필드 이름과 값으로 구성됩니다.
curl은 -F 또는 --form 플래그를 사용하여 FormData를 지정할 수 있습니다. 이 플래그를 사용할 때는 다음 형식으로 필드 이름과 값을 지정합니다: -F <name=content> 또는 --form <name=content>.
다음 코드 조각은 FirstName 및 LastName 필드를 사용하여 FormData로 POST 요청을 전송하는 curl 명령을 보여줍니다:
curl -X POST -F FirstName=Joe -F LastName=Soap https://httpbin.org/anything
httpbin.org 응답 객체의 form 속성에서 양식 필드 이름과 값을 확인할 수 있습니다:
{
"args": {},
"data": "",
"files": {},
"form": {
"FirstName": "Joe",
"LastName": "Soap"
},
"headers": {
"Accept": "*/*",
"Content-Length": "248",
"Content-Type": "multipart/form-data; boundary=------------------------e2bb56049a60b8b8",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": null,
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
서버로 전송하려는 모든 필드에 대해 -F 플래그를 사용합니다.
파일 업로드
FormData를 사용하여 POST 요청에서 파일을 업로드할 수 있습니다. 파일을 필드에 첨부하기만 하면 됩니다. curl이 FormData 필드에 파일이 포함되어 있음을 인식하도록 하려면, 필드 값에 파일 경로를 @ 문자로 시작하여 입력합니다.
다음 curl 명령어는 작업 디렉토리에 있는 Contract.pdf 파일을 업로드합니다. 이 명령어는 File이라는 필드를 사용하여 파일을 업로드합니다:
curl -X POST -F [email protected] https://httpbin.org/anything
응답에는 전체 파일이 포함되므로 길지만, 다음과 같은 형식이어야 합니다:
{
"args": {},
"data": "",
"files": {
"File": "..."
},
"form": {},
"headers": {
"Accept": "*/*",
"Content-Length": "246",
"Content-Type": "multipart/form-data; boundary=------------------------19ed1fc3be4d30c7",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": null,
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
인증 정보 전송
많은 HTTP 엔드포인트는 요청 전송을 위해 인증을 요구합니다. 웹 서버가 사용자가 사용해야 할 인증 방식을 결정합니다. 기본 인증 방식은 요청에 사용자 이름과 비밀번호로 구성된 자격 증명을 전송할 수 있게 해주는 인증 방법 중 하나입니다. 서버는 자격 증명을 확인하고, 올바른 경우 요청을 처리합니다.
curl은 -u 또는 --user 플래그를 사용하여 기본 인증 자격 증명 전송을 간소화합니다. 사용자 이름과 비밀번호를 지정하고 : (콜론)으로 구분하여 다음과 같이 입력합니다: -u <username:password>.
다음 코드 조각은 사용자 자격 증명과 JSON 본문을 포함한 POST 요청을 curl로 전송합니다:
curl -X POST -u 'admin:password123' --json '{
"FirstName": "Joe",
"LastName": "Soap"
}' https://httpbin.org/anything
curl이 사용자 이름과 비밀번호를 인코딩하여 Authorization 헤더로 전송하는 방식을 확인하세요:
{
"args": {},
"data": "{n "FirstName": "Joe",n "LastName": "Soap"n}",
"files": {},
"form": {},
"headers": {
"Accept": "application/json",
"Authorization": "Basic YWRtaW46cGFzc3dvcmQxMjM=",
"Content-Length": "50",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "curl/8.1.2",
"X-Amzn-Trace-Id": "Root=1-11111111-111111111111111111111111"
},
"json": {
"FirstName": "Joe",
"LastName": "Soap"
},
"method": "POST",
"origin": "0.0.0.0",
"url": "https://httpbin.org/anything"
}
모든 중요한 cURL 인수
| 인수 | 전체 옵션 | 간략한 설명 |
|---|---|---|
| -X | –request | 사용할 HTTP 메서드 지정 |
| -d | –data | 요청 본문 데이터 전송 |
| -F | –form | 양식 기반 데이터 전송 |
| -H | –header | 요청 헤더 필드 설정 |
| -i | –include | 응답 헤더 출력 포함 |
| -v | –verbose | 추가 디버그 세부 정보 표시 |
| -L | –location | 리다이렉션을 자동으로 따름 |
| -o | –output | 응답을 파일에 기록 |
| -O | –remote-name | 원격 파일명으로 저장 |
| -C | –continue-at | 지정된 오프셋부터 전송 재개 |
| -u | –user | 기본 인증 자격 증명 설정 |
| -x | –proxy | 지정된 프록시 서버 사용 |
| -k | –insecure | SSL 인증서 검사를 건너뛰기 |
| -I | –head | 헤더만 가져오기 (HEAD) |
| -b | –cookie | 저장된 쿠키 데이터 전송 |
| -c | –cookie-jar | 쿠키를 파일에 기록 |
| -e | –referer | Referer 헤더 설정 |
| -A | –user-agent | 사용자 정의 User-Agent 설정 |
| -m | –max-time | 최대 요청 시간 제한 |
| –max-filesize | (약어 없음) | 다운로드 파일 크기 제한 |
| -z | –time-cond | 다음 조건 충족 시 다운로드 |
| –compressed | (약어 없음) | 압축된 응답 요청 |
| –data-urlencode | (약어 없음) | 데이터 필드 URL 인코딩 |
| –interface | (약어 없음) | 특정 인터페이스에 바인딩 |
| -w | –write-out | 사용자 정의 응답 정보 출력 |
| -r | –range | 특정 바이트 범위 요청 |
| -s | –silent | 진행률 출력 억제 |
| -f | –fail | 오류 발생 시 조용히 실패 처리 |
| -g | –globoff | 괄호 확장을 비활성화 |
| –http1.0 | (약어 없음) | HTTP/1.0 프로토콜 사용 |
| –http1.1 | (약식 없음) | HTTP/1.1 프로토콜 사용 |
| –http2 | (약어 없음) | HTTP/2 프로토콜 사용 |
| –http3 | (약어 없음) | HTTP/3 프로토콜 사용 |
| -Z | –parallel | 동시에 요청 전송 |
| –proxy-user | (약어 없음) | 프록시 인증 자격 증명 |
| –digest | (약어 없음) | HTTP 다이제스트 인증 사용 |
| –ntlm | (약어 없음) | HTTP NTLM 인증 사용 |
| –negotiate | (약어 없음) | SPNEGO/Kerberos 인증 사용 |
결론
이 글에서는 curl 명령줄 유틸리티를 사용하여 POST 요청을 보내는 방법을 설명했습니다. -X 플래그를 사용하여 POST 요청을 보낼 것을 명시하는 방법을 배웠습니다. 또한 -H 및 --header 플래그를 사용하여 Content-Type 및 Accept 헤더를 설정하여 웹 서버가 데이터 형식을 인식하도록 했습니다. 요청 본문에 데이터를 전송하려면 -d 플래그와 함께 전송할 데이터를 사용했습니다.
또한 JSON, XML, FormData 등 다양한 유형의 데이터를 전송하는 몇 가지 예시를 살펴보았으며, -u 및 --user 플래그를 사용하여 요청에 기본 인증 자격 증명을 포함하는 방법도 배웠습니다.
이 글에서는 curl의 기본 플래그와 사용법을 소개했지만, 변수 활용, 요청 시 쿠키 전송, 프록시를 통한 요청 전송 등 curl이 제공하는 더 많은 기능을 탐색해 볼 수 있습니다. 또한 Python, Node.js, Rust 등 다양한 프로그래밍 언어에서 curl을 활용할 수 있는 라이브러리를 제공합니다.
스크래핑 솔루션을 찾고 계신가요? 지금 등록하시고 데이터 전문가와 상담하여 귀사의 요구사항에 가장 적합한 제품을 확인해 보세요.
