Postman 사용법 기초 - API 테스트 입문자를 위한 설치부터 첫 요청까지 단계별 가이드
API 테스트가 처음이라면 Postman부터 시작하세요. 설치 방법, GET과 POST 요청 보내기, 컬렉션 정리, 환경변수 활용까지 초보자가 실습 순서대로 따라 할 수 있게 정리했습니다.
개발 공부를 시작하고 처음 API 문서를 받아 들었을 때, 어디서부터 확인해야 할지 막막했던 경험이 있으실 겁니다. 코드를 한 줄도 쓰지 않고 서버가 제대로 응답하는지 확인할 수 있다면 어떨까요? Postman 사용법 기초만 익혀도 이 고민의 대부분이 해결됩니다. 요청을 버튼 클릭 몇 번으로 보내고, 응답을 화면에서 바로 확인할 수 있기 때문입니다.
Postman이란 - API 테스트의 사실상 표준 도구
Postman은 API를 만들고, 테스트하고, 문서화하는 도구입니다. 초창기에는 크롬 확장 프로그램으로 시작했지만 지금은 Windows, macOS, Linux를 모두 지원하는 독립 프로그램으로 발전했습니다. Postman 공식 발표 기준 전 세계 3천만 명 이상의 개발자가 사용하고 있을 만큼, API 테스트 분야에서는 사실상 표준으로 자리 잡았습니다.
쓰임새는 직군마다 조금씩 다릅니다. 백엔드 개발자는 자신이 만든 API가 의도대로 동작하는지 검증하고, 프론트엔드 개발자는 서버가 어떤 구조의 데이터를 주는지 미리 확인합니다. QA 담당자나 기획자도 화면 없이 기능을 점검할 때 활용합니다. 공통점은 하나입니다. 코드를 작성하기 전에 API를 먼저 검증한다는 것입니다.
API 개발에서 가장 비싼 실수는 배포 후에 발견되는 오류입니다. Postman으로 요청 하나를 미리 테스트하는 데는 1분이면 충분하지만, 운영 환경에서 잘못된 응답의 원인을 추적하는 데는 몇 시간이 걸릴 수 있습니다.
설치와 화면 구성 익히기
공식 홈페이지(postman.com)에서 무료로 내려받을 수 있습니다. 기본 기능은 무료 플랜으로 충분히 쓸 수 있고, 계정을 만들어 로그인하면 작업 내역이 클라우드에 동기화되어 다른 컴퓨터에서도 이어서 작업할 수 있습니다.
설치 후 처음 화면을 열면 크게 네 영역으로 나뉩니다.
- 사이드바: 컬렉션, 환경, 히스토리 등 저장된 항목을 관리하는 왼쪽 영역
- 요청 빌더: HTTP 메서드와 URL을 입력하고 Send 버튼으로 요청을 보내는 중앙 상단 영역
- 요청 옵션 탭: Params, Headers, Body 등 요청의 세부 내용을 설정하는 탭
- 응답 영역: 상태 코드, 응답 시간, 응답 본문이 표시되는 하단 영역
첫 API 요청 보내기 - GET과 POST
본격적으로 요청을 보내기 전에, 가장 자주 쓰는 HTTP 메서드부터 정리하겠습니다. Postman 사용법 기초에서 이 다섯 가지만 알아도 실무 요청의 대부분을 다룰 수 있습니다.
| 메서드 | 용도 | 예시 |
|---|---|---|
| GET | 데이터 조회 | 게시글 목록 불러오기 |
| POST | 데이터 생성 | 회원가입, 글 작성 |
| PUT | 데이터 전체 수정 | 프로필 전체 갱신 |
| PATCH | 데이터 일부 수정 | 닉네임만 변경 |
| DELETE | 데이터 삭제 | 게시글 삭제 |
GET 요청 - 데이터 조회하기
상단의 New 버튼에서 HTTP Request를 선택하고, 메서드를 GET으로 둔 상태에서 테스트할 API 주소를 입력한 뒤 Send 버튼을 누르면 끝입니다. 하단 응답 영역에 상태 코드 200과 함께 JSON 데이터가 표시되면 성공입니다. 처음에는 공공데이터포털이나 연습용 공개 API처럼 인증 없이 호출 가능한 주소로 연습하는 것이 좋습니다.
POST 요청 - 데이터 전송하기
POST는 서버에 데이터를 보내는 요청이라 본문 작성이 필요합니다. 메서드를 POST로 바꾸고 Body 탭에서 raw를 선택한 뒤 오른쪽 드롭다운을 JSON으로 지정합니다. 그러면 Content-Type 헤더가 자동으로 설정되고, 입력창에 JSON 형식으로 보낼 데이터를 작성하면 됩니다.
응답으로 받은 JSON은 응답 영역의 Pretty 보기로 정렬해서 볼 수 있습니다. 다만 서버 로그나 문서에서 복사해 온 한 줄짜리 압축 JSON을 분석해야 할 때도 있는데, 이럴 때는 브라우저에서 바로 쓸 수 있는 JSON 포매터로 정렬하면 중첩 구조를 훨씬 빠르게 파악할 수 있습니다.
컬렉션과 환경변수로 요청 정리하기
요청을 하나씩 보내는 데 익숙해졌다면, 이제 정리하는 습관을 들일 차례입니다. 컬렉션은 관련 요청을 폴더처럼 묶어 두는 기능입니다. 예를 들어 회원 API 컬렉션 안에 회원가입, 로그인, 정보 조회 요청을 저장해 두면 다음에 URL을 다시 입력할 필요가 없습니다.
- 프로젝트별, 기능별로 요청을 묶어 재사용할 수 있습니다
- 팀원에게 컬렉션을 공유해 같은 조건으로 테스트할 수 있습니다
- 요청마다 설명을 남겨 간단한 API 문서처럼 쓸 수 있습니다
환경변수는 여기서 한 단계 더 나아간 기능입니다. 개발 서버와 운영 서버의 주소가 다를 때, URL을 매번 고치는 대신 {{base_url}} 같은 변수를 만들어 두고 환경만 전환하면 됩니다. 왼쪽 사이드바의 Environments 메뉴에서 변수 이름과 값을 등록한 뒤, 요청 URL에 중괄호 두 개로 감싼 변수명을 넣어 사용합니다.
초보자가 알아두면 좋은 실전 팁
기본기를 익힌 뒤에는 아래 습관들이 실력 차이를 만듭니다.
- 상태 코드부터 확인: 200은 성공, 401은 인증 실패, 404는 주소 오류, 500은 서버 오류입니다. 본문을 읽기 전에 상태 코드로 문제 범위를 좁히는 습관을 들이세요.
- 히스토리 활용: 사이드바의 History 탭에 보냈던 요청이 자동 저장됩니다. 어제 테스트한 요청을 다시 찾을 때 유용합니다.
- 코드 스니펫 생성: 요청 화면 오른쪽의 코드 아이콘을 누르면 현재 요청을 curl, JavaScript fetch, Python 등 다양한 언어 코드로 변환해 줍니다. 테스트가 끝난 요청을 실제 코드로 옮길 때 그대로 활용할 수 있습니다.
- Tests 탭 맛보기: JavaScript로 응답 검증 스크립트를 작성하면 상태 코드나 응답 값이 기대와 다를 때 자동으로 알려 줍니다. 입문 단계를 지나면 꼭 익혀 볼 기능입니다.
오늘 해 볼 일은 두 가지입니다. 먼저 Postman을 설치하고 인증이 필요 없는 공개 API에 GET 요청을 한 번 보내 보세요. 그리고 성공한 요청을 첫 컬렉션으로 저장해 보세요. 이 두 단계만 직접 해 보면 API 문서가 더 이상 낯설게 느껴지지 않을 것입니다.
