Postman 사용법 기초 - API 테스트 처음 시작하는 개발자를 위한 입문 가이드
설치부터 첫 요청 전송, 컬렉션과 환경 변수 관리까지. 명령어 없이 클릭만으로 API를 테스트하는 방법을 단계별로 정리했습니다.
API를 처음 다루다 보면 터미널에서 curl 명령어를 외우는 것부터 막막합니다. 헤더 하나 붙이는데도 옵션을 찾아 헤매고, 응답이 한 줄로 쏟아져 나오면 어디서부터 봐야 할지 모르겠습니다. Postman은 이런 과정을 클릭 몇 번으로 바꿔주는 도구입니다. 전 세계 개발자 3천만 명 이상이 사용하는 API 테스트 도구로, 명령어를 몰라도 화면에서 요청을 만들고 응답을 깔끔하게 확인할 수 있습니다.
Postman이란 무엇인가
Postman은 API를 만들고, 보내고, 테스트하고, 문서화하는 작업을 하나의 화면에서 처리하는 협업 플랫폼입니다. 쉽게 말해 웹 서버에 요청을 보내고 그 결과를 사람이 보기 좋게 보여주는 프로그램입니다.
브라우저 주소창에 URL을 입력하면 GET 요청은 보낼 수 있지만, 인증 헤더를 붙이거나 데이터를 담아 보내는 POST 요청은 불가능합니다. Postman은 이런 모든 종류의 요청을 시각적으로 구성하게 해줍니다.
Postman의 핵심 가치는 코드를 한 줄도 작성하지 않고 API의 동작을 확인할 수 있다는 점입니다. 기획자나 디자이너도 개발자와 같은 화면을 보며 소통할 수 있습니다.
설치와 화면 구성 익히기
Postman은 데스크톱 앱과 웹 버전 두 가지로 제공됩니다. 입문자라면 데스크톱 앱을 권장합니다. 로컬 서버(localhost) 요청을 보낼 때 웹 버전보다 제약이 적기 때문입니다.
설치 순서
- 공식 사이트(postman.com)에서 운영체제에 맞는 설치 파일을 받습니다. Windows, macOS, Linux 모두 지원합니다.
- 설치 후 실행하면 로그인 화면이 나옵니다. 계정 없이 사용하려면 하단의 건너뛰기 옵션을 선택할 수 있지만, 작업 내용을 저장하려면 무료 계정 가입을 권장합니다.
- 무료 플랜으로도 개인 학습과 소규모 프로젝트는 충분히 가능합니다.
처음 화면을 열면 복잡해 보이지만 실제로 자주 쓰는 영역은 세 군데뿐입니다. 왼쪽의 컬렉션 사이드바, 가운데의 요청 작성 영역, 아래쪽의 응답 표시 영역입니다.
첫 API 요청 보내기
가장 빠르게 감을 잡는 방법은 직접 한 번 보내보는 것입니다. 무료로 공개된 테스트용 API를 사용하겠습니다.
실습 단계
- 상단 탭에서 새 요청(New Request)을 엽니다.
- 메서드를 GET으로 두고 주소 칸에 https://jsonplaceholder.typicode.com/posts/1 을 입력합니다.
- 오른쪽의 파란 Send 버튼을 누릅니다.
잠시 뒤 아래 응답 영역에 JSON 데이터가 표시됩니다. 상단에는 200 OK라는 상태 코드와 응답 시간(ms), 응답 크기가 함께 나옵니다. 이 세 가지 숫자만 봐도 요청이 정상적으로 처리됐는지 바로 판단할 수 있습니다.
HTTP 메서드와 요청 구성
API 요청은 무엇을 하려는지에 따라 메서드가 달라집니다. 데이터를 읽을 때, 새로 만들 때, 수정할 때, 지울 때 각각 다른 메서드를 씁니다. 자주 쓰는 메서드를 정리하면 다음과 같습니다.
| 메서드 | 용도 | 본문(Body) 필요 |
|---|---|---|
| GET | 데이터 조회 | 없음 |
| POST | 새 데이터 생성 | 필요 |
| PUT | 데이터 전체 수정 | 필요 |
| PATCH | 데이터 일부 수정 | 필요 |
| DELETE | 데이터 삭제 | 대부분 없음 |
요청을 구성하는 네 가지 탭
주소 아래에는 Params, Authorization, Headers, Body 탭이 있습니다. 입문 단계에서 이해해야 할 것은 다음 세 가지입니다.
- Headers: 요청에 대한 부가 정보입니다. JSON 데이터를 보낼 때는 Content-Type을 application/json으로 지정합니다.
- Body: POST나 PUT에서 실제로 보낼 데이터를 담습니다. raw 선택 후 JSON 형식을 고르는 경우가 가장 많습니다.
- Authorization: 인증 정보를 담습니다. Bearer Token, Basic Auth, API Key 방식을 화면에서 선택하면 됩니다.
Basic Auth 방식은 아이디와 비밀번호를 Base64로 인코딩해 헤더에 담는 구조입니다. Postman이 자동으로 변환해 주지만, 헤더에 들어간 값이 실제로 어떻게 인코딩됐는지 직접 확인하고 싶다면 Base64 인코더로 값을 디코딩해 비교해 보면 인증 동작을 이해하는 데 도움이 됩니다.
컬렉션과 환경 변수 활용
요청 하나를 보내는 것까지는 누구나 합니다. Postman을 제대로 쓰는 사람과 아닌 사람의 차이는 컬렉션과 환경 변수를 쓰느냐에서 갈립니다.
컬렉션 - 요청을 폴더로 묶기
컬렉션은 관련된 요청을 모아두는 폴더입니다. 회원 가입, 로그인, 게시글 작성처럼 한 프로젝트의 요청들을 한곳에 정리하면 매번 주소를 새로 입력할 필요가 없습니다. 만들어 둔 요청을 클릭만 하면 바로 재사용됩니다.
환경 변수 - 주소를 한 번에 바꾸기
개발 서버와 실제 운영 서버는 주소가 다릅니다. 요청마다 주소를 일일이 고치면 실수가 생깁니다. 환경 변수를 쓰면 base_url 같은 변수 하나만 바꿔서 전체 요청의 대상 서버를 한 번에 전환할 수 있습니다.
- 오른쪽 상단의 환경(Environment) 메뉴에서 새 환경을 만듭니다.
- base_url 변수에 개발 서버 주소를 넣습니다.
- 요청 주소 칸에는 {{base_url}}/posts 처럼 변수를 중괄호 두 개로 감싸 사용합니다.
실무에서 자주 쓰는 기능
기본 사용법에 익숙해졌다면 작업 속도를 끌어올리는 기능을 익힐 차례입니다.
- History(기록): 보낸 요청은 왼쪽 History 탭에 자동 저장됩니다. 방금 테스트한 요청을 다시 찾을 때 유용합니다.
- Code 스니펫: 요청 오른쪽의 Code(</>) 버튼을 누르면 같은 요청을 curl, Python, JavaScript 등 원하는 언어 코드로 변환해 줍니다. 화면에서 검증한 요청을 그대로 코드에 옮길 수 있습니다.
- Tests 탭: 응답 상태 코드나 특정 값이 맞는지 자동으로 검사하는 간단한 스크립트를 작성할 수 있습니다. 반복 테스트에 효율적입니다.
처음에는 GET 요청 하나 보내는 것부터 시작하면 됩니다. 익숙해지면 컬렉션으로 요청을 정리하고, 환경 변수로 서버를 전환하는 흐름까지 자연스럽게 이어집니다. 오늘 당장 할 일은 두 가지입니다. Postman 데스크톱 앱을 설치하고, 위의 테스트 API 주소로 첫 요청을 직접 보내보는 것입니다. 직접 응답을 받아보는 순간 문서로 읽던 내용이 한 번에 정리됩니다.
