[파이썬] curl 명령어

시작에 앞서

해당 내용은 <가장 빠른 풀스택을 위한 Flask & FastAPI>, Dave Lee 지음. BJ Public 출판.
내용을 토대로 작성되었습니다. 보다 자세한 사항은 해당 교재를 참고하시기 바랍니다.

---

curl 명령어

 

curl은 'Client URL'의 약자로, 다양한 프로토콜을 지원하는 명령행 기반의 네트워크 도구이다.

주로 웹 서버와의 상호작용을 위해 사용되며 HTTP, HTTPS, FTP 등 다양한 프로토콜을 지원한다.

특히 플라스크와 FastAPI의 다양한 기능 테스트 시, POST 방식 요청을 테스트해야 할 때는 웹 주소 외에 특별한 방법이 필요한데, 이를 간단히 테스트할 수 있는 명령어이다.

 

윈도우 버전 10 이상에서는 기본적으로 curl 이 설치되어 있으며, 터미널(cmd)을 켜고 하단의 명령어를 통해 설치 여부를 확인해볼 수 있다.

curl --version

---

curl 주요 옵션

 

1. -X 또는 --request: 사용할 HTTP 메서드를 지정

curl -X POST http://example.com

 

2. -H 또는 --header: HTTP 헤더를 추가

curl -H "Content-Type: application/json" http://example.com

 

3. -d 또는 --data: POST 요청에 데이터를 담는다

curl -d "param1=value&param2=value2" http://example.com

 

4. --data-raw: POST 요청에 원시 데이터를 담는다

curl --data-raw "raw data" http://example.com

 

5. -F 또는 --form: 멀티파트 폼 데이터를 전송

curl -F "file=@/path/to/file" http://example.com/upload

 

6. -u 또는 --user: Basic 인증을 위한 사용자 이름과 패스워드를 지정

curl -u username:password http://example.com

 

7. -o 또는 --output: 출력 결과를 파일에 저장

curl -o output.html http://example.com

 

8. -I 또는 --head: 헤더 정보만 출력

curl -I http://example.com

 

9. -v 또는 --verbose: 요청과 응답 정보를 자세히 출력

curl -v http://example.com

 

10. -L 또는 --location: 서버가 요청을 다른 위치로 리다이렉트하면 따라간다

curl -L http://example.com

 

11. --cookie: 쿠키 전송

curl --cookie "name=value" http://example.com

 

12. --cookie-jar: 응답으로 받은 쿠키를 파일에 저장

curl --cookie-jar cookies.txt http://example.com

---

★ POST란? (출처: 위키백과)

컴퓨팅에서 POST(포스트)는 월드 와이드 웹에 사용되는, HTTP가 지원하는 요청 방식이다. 설계상 POST 요청 방식은 웹 서버가 요청 메시지의 본문에 감싸있는 데이터를 받아들일 것을 요청하며 이러한 정보를 저장할 가능성이 높다. 파일을 업로드할 때나 완성된 웹 폼을 제출할 때 종종 사용된다.