cURL 시작하기: 인터넷에 메시지 보내기

Source: Dev.to

cURL란? (아주 간단히)

cURL은 Client URL의 약자입니다. 버튼도, 이미지도, 색상도 없는 웹 브라우저라고 생각하면 됩니다. URL을 사용해 서버와 데이터를 주고받을 수 있는 명령줄 도구입니다.

브라우저가 모든 것을 화면에 보여주는 TV라면, cURL은 무전기와 같습니다: 서버에 특정 요청을 보내면, 서버가 응답을 텍스트 형태로 돌려줍니다.

프로그래머가 cURL을 필요로 하는 이유

• 속도 – 명령을 입력하는 것이 브라우저를 열고 메뉴를 클릭하는 것보다 빠릅니다.
• 자동화 – 스크립트를 작성해 서버를 수백 번 연속 호출할 수 있습니다.
• API 테스트 – 프론트엔드(UI)가 만들어지기 전에 백엔드(앱의 숨은 로직)가 제대로 동작하는지 확인할 수 있습니다.

cURL로 첫 번째 요청 만들기

터미널(명령 프롬프트, PowerShell, 혹은 기타 쉘)을 열고 다음을 실행합니다:

curl https://www.google.com

Google 서버에 홈페이지를 요청한 것입니다. 렌더링된 페이지 대신 브라우저가 보통 화면에 보여주는 HTML 코드가 그대로 출력됩니다.

요청과 응답 이해하기

cURL 사용은 두 부분으로 이루어집니다:

• 요청 – 당신이 보내는 내용(URL, 메서드, 헤더 등).
• 응답 – 서버가 돌려주는 내용, 일반적으로 다음을 포함합니다:
  • 상태 코드 – 예: 200 OK(성공), 404 Not Found(리소스 없음).
  • 본문 – 실제 데이터(HTML, JSON 등).

cURL로 API와 통신하기

GET 요청 (데이터 조회)

curl https://jsonplaceholder.typicode.com/posts/1

서버는 하나의 “post”를 나타내는 JSON 객체를 반환합니다.

POST 요청 (데이터 전송)

curl -X POST https://jsonplaceholder.typicode.com/posts -d "title=MyNewPost"

새로운 정보를 서버에 전송한 것입니다.

초보자들이 흔히 하는 실수

• 프로토콜을 빼먹음 – 항상 https://를 포함해야 합니다. curl google.com은 실패할 수 있습니다.
• 보이지 않는 문자 – 리치 텍스트에서 복사하면 “스마트 따옴표”(“ ”)가 들어갈 수 있는데, 이는 일반 따옴표(")로 바꿔야 합니다.
• 오류 무시 – -v(verbose) 옵션을 추가해 전체 대화를 확인하세요:

curl -v https://google.com

Resources