Skip to content

배움의 길

평생 배워야하는 것은 우리들의 운명이다.

Menu
Menu

API 테스트 도구 Postman 사용법 총정리: 첫 HTTP 요청(GET·POST) 날려보기

Posted on 2026년 11월 12일2026년 11월 07일 by steve

 

복잡한 코드 없이도 서버와 대화할 수 있을까요? 개발 입문자부터 실무자까지 가장 많이 쓰는 API 테스트 도구 Postman으로 첫 번째 HTTP 요청을 보내고 응답을 확인하는 전 과정을 쉽고 자세하게 안내해 드립니다!

 

처음 웹 개발이나 앱 개발을 공부할 때 가장 막막했던 순간이 언제였나요? 저는 백엔드 서버 API를 만들어 놓고도 이게 제대로 작동하는지 확인할 방법이 없어서 발을 동동 굴렀던 기억이 나요. 프론트엔드 화면을 다 만들자니 시간이 너무 오래 걸리고, 검은색 터미널 창에 복잡한 명령어를 치자니 오타 하나에 에러가 쏟아져서 정말 답답했거든요.

그때 선배 개발자가 추천해 준 도구가 바로 포스트맨(Postman)이었어요. 솔직히 말해서 처음 써봤을 때 “와, 이렇게 편한 걸 왜 이제 알았지?” 싶었답니다. 버튼 몇 번만 클릭하면 서버로 데이터를 보낼 수 있고, 서버가 돌려주는 결과물도 깔끔하게 정리해서 보여주니까요. 오늘은 저처럼 API 테스트 앞에서 막막함을 느끼셨던 분들을 위해, Postman으로 첫 HTTP 요청을 날려보는 방법을 하나씩 같이 해보려고 해요! 😊

 

Postman과 HTTP 요청, 왜 필요할까요? 🤔

본격적으로 프로그램을 다루기 전에 개념부터 가볍게 짚고 넘어갈게요. 우리가 웹 브라우저 주소창에 주소를 입력하고 엔터를 치는 행동도 사실은 서버에 HTTP 요청(Request)을 보내는 거예요. 다만 기본 브라우저 주소창은 데이터를 조회하는 요청만 쉽게 보낼 수 있고, 회원가입이나 게시글 작성처럼 데이터를 서버에 등록하거나 수정하는 요청은 직접 테스트하기가 까다롭습니다.

이럴 때 사용하는 전문 도구가 바로 API 클라이언트인 포스트맨이에요. 우체부 아저씨가 편지를 정확한 주소로 배달하고 답장을 받아오는 것처럼, 우리가 원하는 형식의 데이터를 서버 주소(URL)로 보내고 그 결과인 HTTP 응답(Response)과 상태 코드를 한눈에 확인하게 해주는 고마운 도구랍니다.

💡 알아두세요!
Postman은 데스크톱 앱을 설치해서 쓸 수도 있고, 설치가 부담스럽다면 공식 홈페이지에서 웹 브라우저 버전(Postman Web)으로 바로 실행할 수도 있어요. 무료 계정만으로도 개인 학습과 기본적인 프로젝트 테스트에는 충분한 기능을 제공합니다.

 

꼭 알아야 할 핵심 HTTP 메서드 4가지 📊

포스트맨 화면을 열면 주소 입력창 왼쪽에 알파벳 대문자로 적힌 드롭다운 메뉴가 보일 거예요. 이게 바로 서버에게 “내가 어떤 작업을 하고 싶은지” 알려주는 HTTP 메서드(Method)입니다. 종류가 꽤 많지만 실무와 학습에서 95% 이상 사용하는 핵심 4가지만 먼저 기억하시면 충분해요.

주요 HTTP 메서드 비교표

메서드 역할 (CRUD) 데이터 전달 방식 실제 활용 예시
GET 데이터 조회 (Read) URL 쿼리 파라미터 (Params) 게시글 목록 보기, 상품 검색
POST 데이터 생성 (Create) 요청 본문 (Body – JSON 등) 회원가입, 새 댓글 작성
PUT / PATCH 데이터 수정 (Update) 요청 본문 (Body) + URL 경로 프로필 정보 수정, 비밀번호 변경
DELETE 데이터 삭제 (Delete) URL 경로 변수 위주 작성한 게시글 삭제, 장바구니 비우기

보통 처음 연습할 때는 데이터를 읽기만 하는 GET 요청으로 시작해서, 내가 직접 데이터를 담아 보내는 POST 요청 순서로 넘어가는 게 가장 이해하기 쉽답니다.

⚠️ 주의하세요!
POST나 PUT 요청으로 JSON 데이터를 보낼 때는 반드시 본문 설정에서 Body → raw → JSON 형식을 선택해야 합니다. 기본값인 Text로 둔 채 전송하면 서버가 데이터를 제대로 읽지 못해 400 Bad Request나 415 에러가 발생하는 경우가 정말 많아요!

 

HTTP 요청 구조와 상태 코드 판독기 🧮

포스트맨에서 파란색 Send 버튼을 누르기 전에, 우리가 보내는 요청이 어떤 요소들로 합쳐져서 날아가는지 구조를 알면 에러가 났을 때 원인을 찾기가 훨씬 수월해요.

📝 완성된 HTTP 요청 공식

HTTP 요청 = HTTP 메서드 + 요청 URL(Params 포함) + Headers(부가 정보/인증) + Body(전송할 데이터)

요청을 보내는 단계별 흐름을 정리해 볼까요?

1) 1단계 (목적지 설정): 메서드(GET/POST 등)를 고르고 API 엔드포인트 URL을 입력합니다.

2) 2단계 (옵션 및 데이터 추가): 필요한 쿼리 파라미터(Params), 인증 토큰(Headers), 또는 JSON 데이터(Body)를 채웁니다.

→ 3단계 (전송 및 확인): Send 버튼을 누르고 하단 응답 창에 찍힌 상태 코드(Status)와 응답 본문을 확인합니다.

그런데 응답 창 오른쪽 위에 뜨는 200 OK, 404 Not Found 같은 숫자가 무슨 뜻인지 헷갈릴 때가 있죠? 아래 도구에서 요청 방식과 응답받은 상태 코드를 선택하거나 입력해 보세요. 현재 어떤 상황인지 바로 알려드릴게요!

🔢 HTTP 상태 코드 & 요청 진단 도구

요청 메서드:

응답 상태 코드:

진단 결과:

해결 및 체크 포인트:

 

실무처럼 깔끔하게 관리하는 꿀팁 👩‍💼👨‍💻

요청을 한두 개 보내다 보면 탭이 수십 개씩 열려서 나중에는 어떤 탭이 무슨 API였는지 찾기 힘들어져요. 저도 초보 시절에는 매번 주소를 복사해서 메모장에 적어두곤 했는데요. 포스트맨의 컬렉션(Collections)과 환경 변수(Environments) 기능을 쓰면 작업 효율이 두 배 이상 올라갑니다.

컬렉션(Collections)은 쉽게 말해 북마크 폴더예요. ‘회원 API’, ‘결제 API’처럼 폴더를 만들어 요청을 저장해 두면 언제든 다시 꺼내 쓸 수 있고 팀원에게 파일로 공유할 수도 있어요. 또한 서버 주소 앞부분(예: https://api.example.com)을 {{base_url}} 같은 환경 변수로 등록해 두면, 개발 서버와 운영 서버를 오갈 때 주소 전체를 바꿀 필요 없이 환경 설정만 클릭 한 번으로 전환할 수 있어 정말 편리하답니다.

📌 알아두세요!
요청을 작성한 뒤 단축키 Ctrl + S (Mac은 Cmd + S)를 누르는 습관을 들여보세요. 내가 설정한 헤더와 바디 데이터까지 그대로 컬렉션에 저장되어 다음 날 컴퓨터를 켜도 바로 이어서 테스트할 수 있습니다.

 

실전 예시: 무료 테스트 API로 첫 요청 날려보기 📚

백문이 불여일견이죠! 지금 당장 내 서버가 없어도 전 세계 개발자들이 연습용으로 애용하는 무료 가상 API 서비스인 JSONPlaceholder를 이용해 실제 POST 요청을 보내보겠습니다.

연습 시나리오: 새로운 게시글 등록하기

  • 요청 메서드 및 주소: POST / https://jsonplaceholder.typicode.com/posts
  • 전송할 데이터: 제목(title), 본문(body), 작성자 번호(userId)가 담긴 JSON 객체

실행 단계

1) Postman 상단의 + 버튼을 눌러 새 탭을 열고, 드롭다운에서 POST를 선택한 뒤 위 주소를 입력합니다.

2) 주소창 아래의 Body 탭 클릭 → raw 라디오 버튼 선택 → 오른쪽 끝 텍스트 형식을 JSON으로 변경합니다.

3) 입력창에 {"title": "포스트맨 첫 테스트", "body": "성공했어요!", "userId": 1}을 입력하고 Send를 클릭합니다.

최종 결과

– 응답 상태 코드: 201 Created (초록색 배지로 표시되며 약 200~400ms 소요)

– 응답 본문 결과: 내가 보낸 데이터에 새로운 "id": 101이 추가된 JSON 데이터가 깔끔하게 반환됩니다!

직접 따라 해보시니 생각보다 훨씬 간단하죠? 이렇게 한 번 흐름을 익혀두면 어떤 오픈 API나 사내 서버 API를 만나더라도 두려움 없이 척척 테스트해 볼 수 있답니다.

 

마무리: 핵심 내용 요약 📝

오늘 함께 살펴본 Postman 활용법의 핵심 포인트를 다시 한번 정리해 볼게요.

  1. 목적에 맞는 메서드 선택: 조회는 GET, 생성은 POST, 수정은 PUT/PATCH, 삭제는 DELETE를 선택합니다.
  2. 데이터 위치 구분: 주소 뒤에 붙는 검색 조건은 Params 탭에, 서버로 전송할 JSON 데이터는 Body(raw-JSON) 탭에 작성합니다.
  3. 상태 코드로 결과 판별: 200/201은 성공, 400번대는 내 요청 설정 확인, 500번대는 서버 상태를 점검합니다.

처음에는 낯선 영어 메뉴들 때문에 어렵게 느껴질 수 있지만, 오늘 예제처럼 두세 번만 직접 요청을 날려보면 금방 손에 익으실 거예요. 실습하시면서 막히는 부분이나 더 궁금한 점이 있다면 언제든 댓글로 물어봐주세요~ 😊

💡

한눈에 보는 Postman HTTP 요청 요약 카드

✨ 메서드 선택: GET(조회) / POST(생성) 목적에 맞게 드롭다운에서 먼저 선택해요.
📊 JSON 전송 설정: Body → raw → JSON 설정을 해야 서버가 데이터를 정확히 읽어요.
🧮 요청 구성 공식:

완벽한 API 테스트 = Method + URL(Params) + Headers + Body(JSON)

👩‍💻 실무 관리 팁: Collections 저장 & 환경 변수로 자주 쓰는 API를 폴더별로 깔끔하게 관리하세요.

응답 코드가 200 또는 201이라면 성공! 에러가 나면 상태 코드부터 확인하세요.

자주 묻는 질문 ❓

Q: Postman은 회원가입이나 결제를 해야 쓸 수 있나요?
A: 아니요, 기본적인 HTTP 요청 전송 기능은 무료 플랜으로 평생 사용할 수 있어요. 계정 없이도 가벼운 스크래치패드 형태로 쓸 수 있지만, 무료 계정에 로그인하면 내가 만든 요청 목록(Collections)이 클라우드에 자동 동기화되어 다른 컴퓨터에서도 그대로 불러올 수 있어 로그인 후 사용하시는 걸 추천해요.

Q: 내 컴퓨터에서 띄운 로컬 서버(localhost)로 요청을 보낼 때 웹 버전을 써도 되나요?
A: 브라우저에서 실행하는 Postman Web은 보안 정책 때문에 내 컴퓨터의 localhost에 바로 접근하지 못할 수 있어요. 로컬 개발 서버를 테스트할 때는 데스크톱 앱을 설치하거나 Postman Desktop Agent를 함께 실행해 주시면 문제없이 작동합니다.

Q: Params 탭에 입력하는 것과 Body 탭에 입력하는 건 무슨 차이인가요?
A: Params 탭에 값을 넣으면 URL 주소 끝에 ?page=1&size=10처럼 꼬리표(Query String)가 붙어서 전송돼요. 주로 GET 요청에서 검색어나 페이지 번호를 넘길 때 씁니다. 반면 Body 탭은 주소에 노출되지 않는 본문 공간으로, POST나 PUT 요청에서 회원가입 정보나 긴 JSON 데이터를 보낼 때 사용합니다.

Q: 로그인이 필요한 API는 토큰을 어디에 넣어야 하나요?
A: 주소창 아래의 Authorization 탭을 활용하면 가장 편해요. Type을 Bearer Token으로 고르고 발급받은 토큰 문자열만 붙여넣으면, 포스트맨이 자동으로 Headers에 알맞은 인증 형식을 만들어서 전송해 줍니다.

Q: 포스트맨에서 성공한 요청을 실제 개발 코드로 바꿀 수 있나요?
A: 네, 가능합니다! 포스트맨 화면 오른쪽 사이드바에 있는 </> (Code) 아이콘을 클릭해 보세요. 방금 테스트한 요청을 JavaScript(fetch, axios), Python, Java, cURL 등 원하는 언어의 코드로 즉시 변환해 주어서 복사해 붙여넣기만 하면 됩니다.

최신 글

  • 유료 강의 결제 전 필독! 유튜브 프리미엄급 무료 개발·디자인 채널 추천 모음
  • 비전공자가 생활코딩 유튜브로 프로그래밍 입문한 후기 및 현실 공부 순서
  • 코세라(Coursera) 해외 명문대 온라인 강의 수료 후기: 무료 청강부터 수료증 발급까지
  • 유데미(Udemy) 할인 기간 완벽 정리: 글로벌 IT 강의 80% 이상 싸게 사는 법
  • 클래스101 구독형 서비스(CLASS101+) 요금제 비교와 본전 뽑는 활용법

보관함

  • 2026년 11월
  • 2026년 10월

카테고리

  • 교육

소개 및 문의 · 개인정보처리방침 · 면책조항

©2026 배움의 길 | Design: Newspaperly WordPress Theme