블로그 전체 문서 445 검색 ⌘K

Postman 다운로드·설치 및 API 사용법

postman Postman 다운로드 Postman 설치 Postman 사용법 Postman 사용방법 Postman API 포스트맨 API Postman 웹 Postman Desktop Agent
최종 수정 2026. 8. 12.
QUICK ANSWER
Postman은 공식 다운로드 페이지에서 Windows 10 이상, macOS 11 이상, Linux용 데스크톱 앱을 받을 수 있고 웹 앱으로도 사용할 수 있습니다. 처음에는 데스크톱 앱을 설치해 GET 요청을 보내는 방법이 가장 단순합니다. 웹 앱에서 localhost·사내망 API를 호출하거나 브라우저 CORS 제한을 피해야 한다면 전체 데스크톱 앱과 혼동하지 말고 Postman Desktop Agent를 설치하세요. 무료 플랜으로 기본 API 요청과 Collection을 시작할 수 있지만 협업·AI·자동 실행 등 일부 사용량에는 제한이 있습니다.
Postman
소프트웨어
개발사 Postman, Inc.
현재 계열 Postman v12
지원 환경 Windows 10+·macOS 11+·Linux·Web
Windows x64·ARM64
주요 기능 API 요청·Collection·테스트·문서화
기본 이용 Free 플랜 제공
확인일 2026년 8월 12일
홈페이지 바로가기 ↗

Postman 공식 다운로드

Postman은 API 서버에 요청을 보내고 응답을 확인하는 프로그램입니다. 브라우저 주소창과 달리 GET·POST·PUT·PATCH·DELETE 같은 메서드, 쿼리 파라미터, 헤더, 인증 정보와 JSON 본문을 직접 구성할 수 있습니다. 요청을 저장해 다시 실행하거나 테스트·예제·문서와 함께 팀에 공유하는 기능도 제공합니다.

2026년 8월 12일 기준 공식 문서는 최신 제품군을 Postman v12로 안내합니다. 정확한 패치 버전과 설치 파일은 수시로 바뀌므로 번호를 검색해 오래된 파일을 받지 말고 공식 다운로드 화면에서 현재 운영체제용 파일을 선택하세요.

환경공식 지원 기준다운로드 선택
WindowsWindows 10 이상일반 Intel·AMD PC는 x64, Windows ARM PC는 ARM64
macOSmacOS 11 Big Sur 이상Intel 또는 Apple Silicon
LinuxUbuntu 18.04+·Fedora 32+·Debian 10+x64 또는 ARM64
WebChrome 80+·Firefox 76+·Edge 79+·Safari 13.1.1+웹 앱, 필요 시 Desktop Agent

최신 Windows 데스크톱 앱은 64비트만 제공합니다. 컴퓨터의 설정 > 시스템 > 정보 > 시스템 종류에서 x64 기반인지 ARM 기반인지 확인하세요. 단순히 Windows가 64비트라는 사실만으로 ARM64를 고르는 것이 아니라 CPU 아키텍처가 ARM인 PC에서만 ARM64 설치 파일을 사용합니다.

데스크톱 앱·웹 앱·Desktop Agent 차이

이름이 비슷하지만 세 가지 역할은 다릅니다.

선택요청 편집 화면로컬·사내망 접근적합한 상황
Desktop app설치한 프로그램직접 가능로컬 API 개발·전체 기능 사용
Web app웹 브라우저Agent에 따라 다름설치 없이 빠르게 작업·공유
Desktop Agent화면 없음웹 앱의 요청을 PC에서 전달웹 앱에서 localhost·사내망 호출

Desktop Agent는 Postman 전체 프로그램의 가벼운 버전이 아닙니다. 웹 앱에서 작성한 요청을 현재 PC의 네트워크 환경으로 보내는 연결 도구입니다. 웹 앱의 Cloud Agent는 인터넷에서 접근 가능한 HTTP API에 알맞고, 현재 PC의 localhost나 VPN 안쪽 주소에는 접근할 수 없습니다. Browser Agent는 브라우저 CORS 정책의 영향을 받을 수 있습니다.

처음 Postman을 배우거나 로컬 개발 서버를 자주 테스트한다면 데스크톱 앱이 가장 단순합니다. 조직 정책상 앱 설치가 어렵거나 웹 워크스페이스가 중심이라면 웹 앱과 허용된 Agent 조합을 사용하세요.

Windows·Mac·Linux 설치 방법

Windows

  1. 정보상자의 공식 홈페이지 버튼으로 Postman 다운로드 화면을 엽니다.
  2. 일반 Intel·AMD PC는 Windows x64, ARM PC는 Windows ARM64를 선택합니다.
  3. 받은 설치 파일을 실행합니다.
  4. 설치가 끝나면 Postman을 실행합니다.
  5. 계정으로 로그인하거나 Lightweight API Client로 기본 요청을 시작합니다.

최신 앱은 32비트 Windows용 파일을 제공하지 않습니다. 회사 PC에서 실행 파일 설치가 차단되면 과거 버전을 임의로 받지 말고 조직의 소프트웨어 배포 정책을 확인하세요.

macOS

이 Mac에 관하여에서 칩이 Apple M 계열인지 Intel인지 확인하고 맞는 파일을 받습니다. 압축을 푼 뒤 Postman을 Applications 폴더로 옮기고 실행합니다. 처음 실행할 때 macOS 보안 경고가 나오면 내려받은 위치와 개발사를 확인하세요.

Linux

공식 문서는 Snap 설치를 권장하며 다운로드한 tar.gz 파일로도 설치할 수 있습니다. sudo로 Postman 자체를 실행하지 말고 사용자에게 ~/.config 쓰기 권한이 있는지 확인하세요. 배포판·CPU 아키텍처가 맞지 않거나 OpenSSL 구성에 문제가 있으면 실행이 실패할 수 있습니다.

첫 API 요청 보내기

공식 빠른 시작 예제로 요청 한 번을 보내면 화면 구성을 이해하기 쉽습니다.

  1. Postman에서 새 HTTP 요청 탭을 엽니다.
  2. 메서드를 GET으로 선택합니다.
  3. 주소에 https://postman-echo.com/get을 입력합니다.
  4. Send를 누릅니다.
  5. 응답 영역에서 Status가 200 OK인지 확인합니다.
  6. Body 탭의 JSON 응답을 확인합니다.
  7. 다시 사용할 요청이면 Save를 눌러 새 Collection에 저장합니다.

응답의 Status는 서버가 요청을 어떻게 처리했는지, Headers는 응답 형식·캐시·인증 관련 부가 정보, Body는 실제 결과 데이터를 보여줍니다. 200이 아니라고 무조건 Postman 오류인 것은 아닙니다. 401은 인증, 403은 권한, 404는 주소나 경로, 500대는 서버 처리를 먼저 확인하는 신호입니다.

메서드·파라미터·헤더·Body 입력

입력 위치주로 넣는 내용주의할 점
MethodGET·POST·PUT·PATCH·DELETEAPI 문서와 같은 메서드 선택
Params검색어·페이지·필터 등 쿼리 값URL 인코딩과 중복 키 확인
HeadersContent-Type·Accept·인증 헤더API 문서가 요구한 이름 사용
AuthorizationBearer Token·Basic Auth·OAuth 등토큰을 공개 Collection에 직접 기록하지 않기
BodyJSON·form-data·파일 등Content-Type과 본문 형식 일치

JSON 요청을 보낼 때는 보통 Body에서 raw와 JSON을 선택합니다. API 문서가 multipart/form-data 업로드를 요구하면 form-data, 일반 폼 전송을 요구하면 x-www-form-urlencoded를 선택합니다. 형식을 추측하지 말고 서버 API 문서의 예제와 필수 필드를 기준으로 작성하세요.

Collection·Environment 사용법

Collection은 같은 서비스의 요청을 폴더처럼 묶는 단위입니다. 로그인, 사용자 조회, 주문 생성처럼 기능별 요청을 폴더로 정리하고 요청 예제·테스트·설명을 함께 저장할 수 있습니다.

Environment는 개발·테스트·운영처럼 대상마다 바뀌는 값을 묶습니다. 예를 들어 요청 주소를 다음처럼 작성할 수 있습니다.

{{baseUrl}}/users/{{userId}}

개발 Environment의 baseUrl에는 로컬 주소, 테스트 Environment에는 테스트 서버 주소를 넣으면 요청 자체를 복제하지 않고 대상을 바꿀 수 있습니다. 화면 오른쪽 위에서 현재 Environment를 정확히 선택했는지 확인하세요. 운영 API를 실수로 호출하면 데이터가 바뀔 수 있으므로 쓰기 요청은 특히 주의해야 합니다.

토큰·비밀번호 같은 값은 공개 또는 공유 가능한 초기값에 무심코 넣지 마세요. 현재값·민감 변수 표시·Postman Vault 등 제공되는 보호 기능과 조직의 비밀 관리 정책을 사용하고, 이미 공개된 키는 삭제만 하지 말고 서버에서 폐기·재발급해야 합니다.

간단한 응답 테스트 추가

요청을 수동으로 보는 데서 끝내지 않고 상태 코드를 자동 확인할 수 있습니다. 요청의 Scripts > Post-response에 다음 예제를 넣습니다.

pm.test("Status code is 200", function () {
  pm.response.to.have.status(200);
});

요청을 다시 보내면 Test Results에서 통과 여부를 확인할 수 있습니다. 실제 프로젝트에서는 응답 시간이나 특정 JSON 필드도 검사할 수 있지만, 단순히 테스트 개수를 늘리기보다 API 계약에서 반드시 보장해야 하는 조건을 먼저 작성하세요.

자주 발생하는 오류 해결

증상먼저 확인할 항목
Could not send request주소·프로토콜·DNS·인터넷·VPN·Agent 상태
ECONNREFUSEDAPI 서버 실행 여부, 호스트와 포트
웹에서 CORS 오류Desktop Agent 선택·실행 또는 데스크톱 앱 사용
401 Unauthorized토큰 만료·Authorization 방식·헤더 형식
403 Forbidden계정 권한·API 정책·허용 IP
404 Not FoundbaseUrl·경로·버전·메서드
SSL certificate error서버 인증서 체인·이름·기간, CA·클라이언트 인증서
Proxy authentication required시스템·사용자 지정 프록시와 계정 정보
응답이 오래 걸림서버 상태·VPN·프록시·DNS·타임아웃

Could not send request는 하나의 원인을 뜻하는 서버 응답 코드가 아닙니다. Postman이 서버 응답을 받기 전에 연결이 실패했다는 넓은 메시지입니다. 먼저 같은 주소가 현재 PC에서 접근 가능한지, 로컬 서버가 실행 중인지, 웹 앱의 Agent가 맞는지 순서대로 범위를 줄이세요.

SSL 검증을 끄면 증상이 사라질 수 있지만 서버를 제대로 확인하지 않는 상태가 됩니다. 자체 서명 인증서를 사용하는 개발 환경이라면 신뢰할 CA 인증서를 Postman에 등록하고, 상용·업무 서버라면 서버 인증서 구성을 고치는 것이 우선입니다.

무료 플랜과 유료 기능 구분

Postman Free 플랜은 기본 API Client, Collection과 개인 학습을 시작하기에 충분합니다. 유료 플랜은 팀 규모와 협업·거버넌스·자동화·AI 사용량에 따라 구분됩니다. 공식 가격과 한도는 바뀔 수 있으므로 이 페이지에는 특정 유료 금액을 고정하지 않았습니다.

팀에 도입할 때는 단순히 요청을 보낼 수 있는지만 보지 말고 다음을 함께 확인하세요.

  • 워크스페이스와 Collection을 볼 수 있는 사람
  • Environment의 민감 값 공유 범위
  • Collection Runner·성능 테스트·모니터 사용량
  • API 문서와 Git 연동 방식
  • 퇴사·프로젝트 종료 시 계정과 데이터 회수 정책

개인 테스트에서 잘 동작한 Collection을 그대로 공개 워크스페이스로 옮기기 전에 토큰, 쿠키, 고객 데이터와 내부 주소가 들어 있지 않은지 검토하세요.

출처

자주 묻는 질문

Postman은 어디에서 다운로드하나요?
postman.com/downloads 공식 페이지에서 운영체제에 맞는 데스크톱 앱을 받으세요. Windows는 x64와 ARM64, Mac은 Intel과 Apple Silicon, Linux는 x64와 ARM64 빌드를 구분합니다. 검색 광고나 재배포 사이트의 설치 파일보다 공식 페이지를 이용하는 것이 안전합니다.
Postman은 어떤 프로그램인가요?
API 주소, HTTP 메서드, 파라미터, 헤더, 인증 정보와 본문을 입력해 요청을 보내고 응답 상태·헤더·본문을 확인하는 API 클라이언트입니다. 요청을 Collection으로 묶고 변수·테스트·문서·공유 기능을 함께 관리할 수 있습니다.
Postman은 무료인가요?
네. 개인 학습과 기본 API 개발을 시작할 수 있는 Free 플랜이 있습니다. 다만 팀 협업, 자동화 실행, 성능 테스트, AI 크레딧과 일부 고급 기능은 플랜별 제한이 있으므로 업무 도입 전 공식 가격표의 최신 한도를 확인하세요.
데스크톱 앱과 웹 앱 중 무엇을 사용하면 되나요?
로컬 API 개발과 인증서·프록시·요청 캡처 등 전체 기능이 필요하면 데스크톱 앱이 단순합니다. 설치 없이 빠르게 요청을 확인하거나 브라우저에서 작업하려면 웹 앱을 사용할 수 있지만 localhost·사내망 접근과 CORS 제한 때문에 Desktop Agent가 추가로 필요할 수 있습니다.
Postman Desktop Agent는 데스크톱 앱과 같은가요?
아닙니다. Desktop Agent는 웹 앱이 현재 PC를 통해 요청을 보내도록 연결하는 보조 프로그램이고 요청 편집 화면 자체는 웹 브라우저에 있습니다. Postman 데스크톱 앱을 사용 중이라면 별도의 Agent를 선택할 필요가 없습니다.
Postman은 로그인 없이 사용할 수 있나요?
데스크톱 앱의 Lightweight API Client에서는 로그인하지 않고 기본 요청을 보낼 수 있습니다. 계정에 로그인하면 Collection 저장·동기화·워크스페이스 공유 같은 기능을 쓰기 편하지만, 공개 또는 팀 워크스페이스에 비밀 토큰이 공유되지 않도록 변수와 권한을 확인해야 합니다.
32비트 Windows에서도 최신 Postman을 설치할 수 있나요?
최신 Postman 데스크톱 앱은 Windows x64 또는 ARM64용입니다. 공식 문서에 따르면 v9.4가 32비트 Windows를 지원한 마지막 버전이며 현재 32비트 설치 파일은 제공되지 않습니다. 오래된 버전을 계속 쓰기보다 64비트 운영체제로 전환하거나 지원되는 브라우저의 웹 앱을 검토하세요.
Postman으로 첫 API 요청은 어떻게 보내나요?
새 HTTP 요청 탭에서 메서드를 GET으로 두고 주소에 postman-echo.com/get을 입력한 뒤 Send를 누릅니다. Status 200과 응답 본문을 확인하고 계속 사용할 요청이라면 Save를 눌러 Collection에 저장하세요.
Collection과 Environment의 차이는 무엇인가요?
Collection은 요청·폴더·예제·테스트를 기능이나 API별로 묶는 단위입니다. Environment는 개발·테스트·운영처럼 대상에 따라 달라지는 baseUrl, token 등의 변수 값을 한 묶음으로 관리합니다. 같은 요청에서 Environment만 바꾸면 주소와 값을 반복해서 수정하지 않아도 됩니다.
웹 Postman에서 localhost 요청이 안 되는 이유는 무엇인가요?
웹 앱이 Cloud Agent나 Browser Agent를 사용하면 현재 PC의 localhost·사설망에 접근하지 못하거나 브라우저 CORS 제한을 받을 수 있습니다. Agent 선택에서 Desktop Agent를 고르고 보조 프로그램이 실행 중인지 확인하세요. 데스크톱 앱이라면 API 서버가 실제로 실행 중이고 주소·포트가 맞는지 먼저 확인합니다.
SSL 인증서 오류가 나오면 검증을 꺼도 되나요?
임시로 SSL 검증을 끄는 방법을 상시 해결책으로 쓰지 마세요. 사내 인증기관이나 자체 서명 인증서를 사용하는 환경이면 Settings의 Certificates에서 신뢰할 CA 인증서 또는 필요한 클라이언트 인증서를 등록하고, 서버 인증서의 이름·유효기간·체인도 함께 확인해야 합니다.
회사 프록시 환경에서 Postman을 설정하는 방법은 무엇인가요?
데스크톱 앱은 기본적으로 시스템 프록시 설정을 사용할 수 있고 Settings > Proxy에서 시스템 프록시, 사용자 지정 프록시와 인증 정보를 조정할 수 있습니다. VPN·보안 프로그램·조직 정책이 요청을 가로채는 환경이면 임의로 우회하기보다 회사 IT 관리자가 제공한 프록시와 인증서 설정을 사용하세요.
관련 문서