처음 웹 개발이나 앱 개발을 공부할 때 가장 막막했던 순간이 언제였나요? 저는 백엔드 서버 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 활용법의 핵심 포인트를 다시 한번 정리해 볼게요.
- 목적에 맞는 메서드 선택: 조회는 GET, 생성은 POST, 수정은 PUT/PATCH, 삭제는 DELETE를 선택합니다.
- 데이터 위치 구분: 주소 뒤에 붙는 검색 조건은 Params 탭에, 서버로 전송할 JSON 데이터는 Body(raw-JSON) 탭에 작성합니다.
- 상태 코드로 결과 판별: 200/201은 성공, 400번대는 내 요청 설정 확인, 500번대는 서버 상태를 점검합니다.
처음에는 낯선 영어 메뉴들 때문에 어렵게 느껴질 수 있지만, 오늘 예제처럼 두세 번만 직접 요청을 날려보면 금방 손에 익으실 거예요. 실습하시면서 막히는 부분이나 더 궁금한 점이 있다면 언제든 댓글로 물어봐주세요~ 😊
한눈에 보는 Postman HTTP 요청 요약 카드
자주 묻는 질문 ❓
localhost에 바로 접근하지 못할 수 있어요. 로컬 개발 서버를 테스트할 때는 데스크톱 앱을 설치하거나 Postman Desktop Agent를 함께 실행해 주시면 문제없이 작동합니다.?page=1&size=10처럼 꼬리표(Query String)가 붙어서 전송돼요. 주로 GET 요청에서 검색어나 페이지 번호를 넘길 때 씁니다. 반면 Body 탭은 주소에 노출되지 않는 본문 공간으로, POST나 PUT 요청에서 회원가입 정보나 긴 JSON 데이터를 보낼 때 사용합니다.</> (Code) 아이콘을 클릭해 보세요. 방금 테스트한 요청을 JavaScript(fetch, axios), Python, Java, cURL 등 원하는 언어의 코드로 즉시 변환해 주어서 복사해 붙여넣기만 하면 됩니다.