JSCODE Logo
프로그래밍 과외블로그후기멘토진
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호
학원 명칭 : 제이에스코드(JSCODE)원격학원학원설립ㆍ운영 등록번호 : 제6063호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2025 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침
← 블로그 목록으로 돌아가기

서버가 잘 작동하는 지 API 요청 보내보기 (curl)

JSCODE 박재성
JSCODE 박재성
2025-12-06
author
JSCODE 박재성
category
Linux
createdAt
Dec 6, 2025
series
비전공자도 이해할 수 있는 리눅스 입문/실전
slug
test-api-with-curl
type
post
updatedAt
Dec 6, 2025 05:39 AM

✅ 서버가 잘 작동하는 지 API 요청 보내보기 (curl)

실제 백엔드 서버를 띄우고나서 테스트를 할 때 많이 활용하는 툴로 포스트맨(Postman)이 있다. 포스트맨(Postman)을 활용하면 다양한 형태의 API 요청을 보낼 수 있어 테스트하기가 용이하다.
notion image
리눅스에서도 포스트맨(Postman)과 같은 역할을 하는 curl이라는 명령어가 있다. curl 명령어를 활용하면 GET, POST, PUT, DELETE 등 포스트맨(Postman)처럼 다양한 형태로 요청을 보낼 수 있다.
 
[예시]
# GET 형식 $ curl http://example.com/api/data # POST 형식 $ curl -X POST http://localhost:8080/api/users \ -H "Content-Type: application/json" \ -d '{"name": "홍길동", "email": "gildong@example.com"}' # PUT 형식 $ curl -X PUT http://localhost:8080/api/users/1 \ -H "Content-Type: application/json" \ -d '{"name": "홍길동", "email": "gildong@example.com"}' # 등등
그런데 위 예시를 보면 GET 요청을 제외하고는 명령어가 다소 복잡하기 때문에, 간단하게 GET 요청으로만 API를 테스트하면 될 때에만 curl을 사용한다.
 
 

✅ 실전에서 많이 사용하는 상황

  1. 리눅스 환경에서 실행시킨 서버가 정상적으로 작동하는 지 체크하고 싶을 때
    1. $ curl localhost:8080 # Spring Boot 서버가 내부에서 잘 실행되고 있는 지 체크 $ curl [EC2 퍼블릭 IP]:8080 # Spring Boot 서버가 외부 IP로도 요청이 되는 지 체크 $ curl localhost:9999 # 잘못된 주소로 요청보내보기
      notion image
      만약 curl 명령어를 몰랐다면 귀찮게 브라우저를 직접 켜서 테스트 해보거나 포스트맨(Postman)을 켜서 테스트해봐야 한다.
       
  1. 외부의 API 서버가 잘 작동하는 지 체크하고 싶을 때
    1. $ curl https://jsonplaceholder.typicode.com/posts # 샘플 API 주소
       
 

✅ 정리

  • curl은 API 요청을 보낼 수 있는 명령어다.
  • GET 요청을 빠르게 보내보고 싶을 때 주로 사용한다.
 
author
JSCODE 박재성
category
Linux
createdAt
Dec 6, 2025
series
비전공자도 이해할 수 있는 리눅스 입문/실전
slug
type
series-footer
updatedAt
Dec 6, 2025 05:28 AM
📎
이 글은 비전공자도 이해할 수 있는 리눅스 입문/실전 강의의 수업 자료 중 일부입니다.