curl -X POST 뜻은?

 

curl -X POST는 터미널에서 HTTP POST 요청을 보내는 명령어입니다. 각 부분을 쪼개서 설명드릴게요.

명령어 구조

curl -X POST [URL]

 

구성 요소	의미
curl	Client URL의 약자. 터미널에서 URL로 요청을 보내는 도구
-X	HTTP 요청 메서드(Method)를 지정하는 옵션 (--request의 축약형)
POST	HTTP 메서드 중 하나. 서버에 데이터를 생성/전송할 때 사용

 

즉, -X POST는 **"이 요청을 POST 방식으로 보내라"**는 의미입니다.

HTTP 메서드 비교

-X 뒤에 올 수 있는 주요 메서드는 다음과 같습니다.

 

메서드	용도	예시
GET	데이터 조회 (기본값, 생략 가능)	게시글 목록 조회
POST	데이터 생성/전송	회원가입, 로그인, 글쓰기
PUT	데이터 전체 수정	프로필 전체 업데이트
PATCH	데이터 부분 수정	이메일만 변경
DELETE	데이터 삭제	게시글 삭제

실전 예시

1. 가장 단순한 POST 요청

curl -X POST https://api.example.com/login

2. JSON 데이터 함께 전송 (가장 자주 쓰는 형태)

curl -X POST https://api.example.com/login \
  -H "Content-Type: application/json" \
  -d '{"username": "kim", "password": "1234"}'

• -H: Header 추가 (요청 헤더 설정)
• -d: Data 전송 (요청 본문에 데이터 담기)
• Content-Type: application/json: 본문이 JSON 형식임을 명시

3. 폼 데이터 전송

curl -X POST https://api.example.com/signup \
  -d "username=kim&email=kim@test.com"

4. 인증 토큰과 함께 전송

curl -X POST https://api.example.com/posts \
  -H "Authorization: Bearer abc123token" \
  -H "Content-Type: application/json" \
  -d '{"title": "안녕", "content": "첫 글"}'

자주 쓰는 옵션 모음

옵션	의미
-X 또는 --request	HTTP 메서드 지정
-H 또는 --header	헤더 추가
-d 또는 --data	요청 본문 데이터 (POST/PUT 시)
-i	응답 헤더까지 함께 출력
-v	상세 디버깅 정보 출력 (verbose)
-o 파일명	응답을 파일로 저장
-s	진행률 표시 숨김 (silent)
-u 아이디:비번	Basic 인증

사용 목적

curl -X POST는 주로 이런 상황에서 씁니다.

• API 테스트: 백엔드 API가 정상 동작하는지 빠르게 확인
• 자동화 스크립트: 셸 스크립트나 배치 작업에서 외부 API 호출
• 디버깅: Postman 같은 GUI 도구 없이 빠르게 요청 확인
• CI/CD: 빌드 후 배포 알림 전송 등

참고: -X POST가 생략 가능한 경우

-d 옵션을 쓰면 curl이 자동으로 POST 요청으로 인식하기 때문에 -X POST를 생략해도 됩니다.

# 아래 두 명령어는 동일하게 동작
curl -X POST -d "data=value" https://example.com
curl -d "data=value" https://example.com

 

 

다만 명시적으로 적어두는 게 가독성에 좋아서 실무에서는 보통 -X POST를 같이 씁니다.