개발도구

Postman(포스트맨) 다운로드와 API 테스트 시작

포스트맨

Postman

개발사
Postman, Inc.
라이선스
Free 1인 플랜 / Solo·Team·Enterprise 유료
OS
Windows / macOS / Linux

Postman은 HTTP·GraphQL·gRPC·WebSocket 등 API 요청을 만들고 컬렉션·테스트·문서로 관리하는 API 플랫폼입니다. Free는 1인 핵심 테스트용이며 협업과 고급 자동화는 유료 플랜 대상입니다.

1. Postman은 어떤 도구인가

Postman은 API 요청의 메서드·주소·헤더·인증·본문을 구성하고 응답 상태·헤더·본문·시간을 확인하는 개발 도구이자 클라우드 API 플랫폼입니다. HTTP뿐 아니라 GraphQL, gRPC, WebSocket, Socket.IO, MQTT 등 지원 요청을 다루고, 관련 요청을 컬렉션으로 묶어 변수·스크립트·테스트와 함께 실행할 수 있습니다. 예제와 문서를 만들고 mock server·monitor·Flows·Git 연동을 이용할 수 있지만 제공량과 협업 범위는 플랜마다 다릅니다.

2026년 3월 이후 신규 요금제는 Free·Solo·Team·Enterprise입니다. Free는 핵심 API 클라이언트와 개인 개발·테스트를 위한 1인 플랜이며 팀 생성·공동 편집은 유료 Team 이상이 필요합니다. 새 플랜의 collection run과 mock server는 무제한이지만 Postman AI 크레딧, monitor 요청, Flows, Postman API 호출과 보안·관리 기능에는 플랜별 한도나 사용량 과금이 있습니다. 기존 Basic·Professional 고객은 레거시 조건이 남을 수 있으므로 오래된 블로그의 ‘무료 3인 팀’이나 과거 runner 제한을 현재 신규 Free에 그대로 적용하면 안 됩니다. 결제 전 현재 가격·연간 청구·초과 과금 설정을 확인하세요.

데스크톱 앱은 Windows 10 이상, macOS 11 이상과 Ubuntu 18.04·Fedora 32·Debian 10 이상의 지원 Linux를 대상으로 하며 Intel 64비트와 ARM 64비트 설치판을 제공합니다. 웹 앱도 있지만 브라우저 보안 모델 때문에 CORS와 로컬·사설 네트워크 요청에 제약이 있습니다. Desktop Agent는 웹 화면의 요청을 사용자 PC에서 보내 CORS와 내부망 접근을 처리하고, Cloud Agent는 Postman 클라우드 서버에서 HTTP 요청을 보내므로 localhost·사설망에 접근하지 못합니다. Desktop Agent는 웹 앱의 요청 중계기이고 완전한 데스크톱 앱과는 다릅니다. 프록시·트래픽 캡처·컬렉션 실행 결과 내보내기 같은 전체 기능에는 데스크톱 앱이 권장됩니다.

API 키·토큰·비밀번호는 일반 environment·collection 변수에 평문처럼 넣어 공유하지 마세요. workspace 공개 범위, fork·export와 클라우드 동기화를 통해 값이 퍼질 수 있습니다. Postman Local Vault는 본인 장치에서만 접근하고 클라우드에 동기화하지 않는 비밀 저장소이며 Shared Vault는 암호화되지만 workspace 팀이 접근하고 클라우드와 동기화합니다. 비밀의 용도와 조직 정책에 맞는 vault를 고르고 허용 도메인을 제한하며, 실수로 공개한 키는 변수에서 지우는 것만으로 끝내지 말고 발급 서비스에서 즉시 폐기·재발급해야 합니다. 운영 API 테스트는 테스트 계정·최소 권한 토큰과 비파괴 요청을 사용해야 합니다.

2. 앱·웹과 Agent 선택

편집 화면과 요청을 실행하는 위치
방식 고를 때 확인할 점
데스크톱 앱 별도 앱에서 API 요청과 기능을 사용할 때 공식 Downloads의 The Postman app 구역에서 기기 선택
웹 앱 브라우저에서 API 작업을 시작할 때 계정 로그인·브라우저 제한과 사용할 Agent 확인
Desktop Agent 웹에서 로컬·사설망 요청이 필요할 때 내 PC에서 실행하는 보조 도구. 완전한 앱과 다름
Cloud Agent Postman 서버에서 HTTP 요청을 보낼 때 localhost·사설망 접근 불가. 요청 실행 위치가 다름

데스크톱 앱이 목적이면 위 다운로드 버튼에서 The Postman app 구역을 찾으세요. 페이지 앞부분에 있는 CLI·플러그인을 먼저 설치할 필요는 없습니다. OS·CPU 선택은 그 공식 화면에서 진행합니다. 웹 앱은 별도 실행 버튼으로 연결됩니다.

3. 첫 요청에서 확인할 것

  1. 테스트용 HTTP 요청을 만들고 메서드와 API 주소를 고릅니다. 처음에는 API 문서의 조회 예제를 사용하세요.
  2. Params·Authorization·Headers·Body를 문서와 대조합니다. 환경 변수가 있으면 현재 해석된 값이 어느 서버를 가리키는지도 확인합니다.
  3. 실제로 사용할 앱·Agent가 그 대상에 연결할 수 있는지 확인한 뒤 Send를 누릅니다. 요청 저장은 전송과 별개입니다.
  4. 응답 상태·헤더·본문을 함께 확인합니다. 200 같은 상태 코드만으로 원하는 데이터·처리가 맞다고 단정하지 않습니다.

직접 입력할 예제가 없으면 공식 Echo GET 예제로 기본 흐름을 확인할 수 있습니다. 운영 API나 실제 키를 첫 연습에 사용할 필요는 없습니다.

4. 기존 요청과 변수를 이어 쓸 때

API 문서의 cURL을 이미 갖고 있다면 cURL 가져오기·필드 확인에서 단일 요청으로 옮기는 과정을 볼 수 있습니다. 가져오기와 오른쪽 Code의 cURL 생성은 반대 방향의 작업입니다.

주소나 인증에 변수를 쓴다면 환경 생성·선택과 값의 범위를 확인하세요. 대표의 기본 시작 흐름과 달리 두 가이드는 이미 가진 요청을 변환하거나 변수의 실제 해석값을 확인하는 독립 과업입니다.

도구 선택부터 다시 필요하면 HTTPie의 CLI·GUI, Hoppscotch의 웹·공식 앱, Bruno의 파일 컬렉션, Insomnia의 저장 방식을 목적에 맞게 비교하세요.

로컬 요청과 Git 작업을 유지하려면 Yaak, API 정의에서 문서·Mock·팀 테스트를 함께 관리하려면 Apifox도 비교할 수 있습니다. Yaak의 개인 무료를 업무 무료로 해석하거나 Apifox 무료 플랜을 모든 팀 기능의 무제한 제공으로 보지 마세요.

API 클라이언트 비교에서 로컬/Git·온라인 팀 작업·현재 사용권으로 선택하세요. 기존 요청을 옮길 때는 인증·변수·스크립트·응답 검증을 작은 사본에서 확인하고, 기존 Postman 작업공간의 공개 범위와 비밀값도 함께 관리합니다.

5. 검색 서버 API: JSON·인증서

Elasticsearch·OpenSearch 요청은 실제 API 주소·메서드와 필요한 인증을 먼저 맞춥니다. 쿼리 문자열인 Params와 JSON 본문을 구분하고, 본문이 필요한 요청은 Body → raw → JSON으로 지정합니다. 이 선택은 Content-Type에도 영향을 주며 수동으로 넣은 헤더가 있으면 그 값이 우선합니다.

HTTPS 원본이 자체 CA를 사용한다면 신뢰할 CA의 PEM을 Certificates에 추가하는 방식을 확인합니다. CA는 서버 인증서를 신뢰하기 위한 것이고, mTLS의 클라이언트 인증서는 자신의 신원을 증명하는 별도 항목입니다. 웹 앱의 인증서 관리는 Desktop Agent가 필요합니다.

실제 키·비밀번호와 내부 데이터는 공개 요청·공유 예제에 넣지 않습니다. 인증서 문제는 서버 주소·CA·유효기간과 요구된 인증을 확인하며 SSL 검증 해제를 기본 해결법으로 삼지 않습니다.

6. 주요 기능

  • HTTP·GraphQL·gRPC·WebSocket·MQTT 등 API 요청 실행
  • 컬렉션·환경·변수와 사전·응답 스크립트
  • 응답 검증 테스트와 collection runner·성능 테스트
  • API 문서·mock server·monitor·Flows
  • 데스크톱 앱과 웹 앱·Desktop/Cloud Agent
  • Local·Shared Vault 기반 API 비밀값 관리

7. 시스템 요구사항

Windows
Windows 10 이상; Intel 64비트·ARM 64비트 설치판
macOS
macOS 11 Big Sur 이상; Intel·Apple Silicon 설치판
Linux
Ubuntu 18.04+·Fedora 32+·Debian 10+; Intel 64비트·ARM 64비트
웹
Chrome 80+·Firefox 76+·Edge 79+·Safari 13.1.1+; Agent별 CORS·내부망 제한
계정플랜
Free는 1인 핵심 테스트용; 협업·고급 자동화·관리 기능은 유료
보안
API 키·토큰은 Local/Shared Vault와 workspace 공개 범위를 구분

8. 설치 방법

  1. 1.

    데스크톱 앱은 위 다운로드 버튼의 The Postman app 구역에서 기기에 맞게 선택합니다. 웹을 쓰려면 별도 웹 앱 실행 버튼으로 시작합니다.

  2. 2.

    개인 Free와 팀 협업·고급 기능의 사용 조건을 구분하고, 필요한 경우 현재 플랜·사용량을 확인합니다.

  3. 3.

    웹 앱에서 localhost·사설망·CORS 제한이 있으면 Desktop Agent 또는 데스크톱 앱을 사용합니다.

  4. 4.

    테스트용 workspace와 environment를 만들고 API 키·토큰은 일반 공유 변수가 아닌 적절한 Vault에 둡니다.

  5. 5.

    운영 API에 보내기 전 메서드·주소·본문과 계정 권한을 확인하고 비파괴 테스트부터 실행합니다.

9. 자주 발생하는 문제

웹 앱에서 CORS 오류 또는 localhost 연결 실패가 날 때

Browser Agent 대신 실행 중인 Desktop Agent를 선택하거나 완전한 데스크톱 앱을 사용합니다. Cloud Agent는 사설·로컬 주소에 접근하지 못하므로 요청이 나가는 위치도 확인하세요.

데스크톱 앱 설치·실행이 안 될 때

지원 OS와 Intel 64비트·ARM 64비트 설치 파일을 확인합니다. Linux는 sudo로 실행하지 말고 설정 폴더 쓰기 권한과 OpenSSL·배포판 요구 패키지를 점검하세요.

환경을 바꿨는데 잘못된 서버로 요청이 갈 때

현재 선택한 environment와 v12의 Value·Shared Value, 같은 이름을 덮어쓰는 변수 범위를 확인하고 요청의 실제 해석 주소를 검토합니다. 운영 서버에는 테스트용 최소 권한 계정과 안전한 요청을 먼저 사용하세요.

API 키가 workspace·Git·문서에 노출됐을 때

값을 숨기거나 삭제하는 데서 끝내지 말고 발급 서비스에서 키를 즉시 폐기·재발급합니다. 이력·fork·export 범위를 조사하고 이후에는 Vault와 허용 도메인을 사용하세요.

기능이 갑자기 제한되거나 결제 안내가 나올 때

현재 계정이 신규 Free·Solo·Team·Enterprise인지 레거시 플랜인지 확인하고 AI·monitor·Flows·API 호출 사용량을 봅니다. 초과 과금이 켜졌다면 관리자·결제 설정도 점검하세요.

10. 포스트맨과 비슷한 프로그램 비교

cURL
설치 환경과 CI에서 재현하기 쉽고 요청을 코드로 검토하기 좋습니다. Postman은 요청·응답·변수·테스트를 시각적으로 구성하고 컬렉션으로 공유하기 편합니다.
Insomnia
API 요청과 GraphQL을 비교적 간결한 클라이언트에서 다룹니다. Postman은 mock·monitor·문서·Flows·조직 관리까지 플랫폼 범위가 넓습니다.
Visual Studio Code REST 확장
요청을 텍스트 파일로 저장해 Git 리뷰와 코드 옆 관리가 쉽습니다. Postman은 GUI 컬렉션·환경·팀 workspace와 실행 결과 관리가 중심입니다.

11. 자주 묻는 질문

Postman은 무료인가요?

+

현재 Free는 핵심 개인 API 개발·테스트를 위한 1인 플랜입니다. 팀 협업은 Team 이상이며 AI·monitor·Flows·API 호출 등은 플랜별 한도나 사용량 과금이 있을 수 있습니다.

웹 앱과 데스크톱 앱은 같은가요?

+

핵심 작업은 비슷하지만 웹은 CORS·내부망·일부 기능 제약이 있습니다. 전체 기능과 로컬 요청에는 데스크톱 앱이 권장되고 웹에서는 필요에 따라 Desktop Agent를 함께 사용합니다.

Cloud Agent와 Desktop Agent의 차이는 무엇인가요?

+

Cloud Agent는 Postman 서버에서 HTTP 요청을 보내 localhost·사설망에 접근하지 못합니다. Desktop Agent는 사용자 PC와 네트워크에서 요청을 보내 CORS를 우회하고 더 많은 프로토콜을 지원합니다.

환경변수에 API 키를 저장해도 안전한가요?

+

v12의 Value는 기본 로컬 값이며 Share로 공유하면 별도의 공유 값이 생깁니다. API 키는 Secure 또는 Vault의 조건을 확인하세요. Secure는 Local Vault 키로 암호화하며, 팀·Cloud에서 쓰려면 Shared Vault와 참조 변수의 공유 범위를 함께 확인해야 합니다. 내보내기·공개 workspace에도 주의하고 이미 노출된 키는 폐기하세요.

Postman에서 운영 서버 API를 바로 테스트해도 되나요?

+

삭제·결제·메일 발송 같은 요청은 실제 작업을 일으킬 수 있습니다. 테스트 환경·최소 권한 계정과 비파괴 메서드를 우선하고 URL·본문·변수 대상이 운영인지 매번 확인하세요.

출처: Postman 공식 다운로드, Postman 공식 시스템 요구사항, Postman 데스크톱·웹 설치와 기능 제한

관련 프로그램