Rihpig

Posted on Jun 9 • Originally published at apidog.com

Postman 컬렉션을 팀 플랜 업그레이드 없이 공유하는 방법

TL;DR (요약)

Postman 무료 요금제는 비공개 워크스페이스 협업을 허용하지 않아 컬렉션 공유가 어렵습니다. JSON 내보내기, 공개 워크스페이스, Git 저장소 활용 같은 우회 방법은 가능하지만 동기화, 보안, 운영 비용 문제가 있습니다. Apidog 무료 플랜은 업그레이드 없이 최대 3명의 사용자와 공유 워크스페이스를 사용할 수 있습니다.

오늘 Apidog를 사용해 보세요

💡 Apidog는 무료 올인원 API 개발 플랫폼입니다. API 디자인, 테스트, 목킹, 문서화를 단일 도구에서 처리할 수 있으며, 무료 요금제에도 실제 협업 기능이 포함되어 있습니다. 신용카드 없이 Apidog를 무료로 사용할 수 있습니다.

서론

Postman은 간단한 HTTP 요청 도구에서 API 플랫폼으로 발전했습니다. 하지만 팀 단위로 컬렉션을 공유하고 실시간 협업을 하려면 유료 플랜이 필요합니다.

소규모 팀, 사이드 프로젝트, 초기 스타트업에서는 단순히 컬렉션을 공유하기 위해 사용자당 월 19달러를 지불하는 것이 부담이 될 수 있습니다. 사용자 1명 기준으로도 연간 228달러입니다.

이 글에서는 Postman 무료 플랜에서 컬렉션을 공유하는 현실적인 방법을 정리합니다. 각 방법의 설정 절차, 한계, 그리고 무료 협업이 필요한 팀이 선택할 수 있는 대안을 함께 살펴봅니다.

Postman 무료 플랜이 실제로 허용하는 것

먼저 2024-2025년 기준 Postman 무료 플랜의 주요 제한을 이해해야 합니다.

Postman 무료 플랜에는 다음이 포함됩니다.

워크스페이스당 사용자 1명
최대 3개의 활성 공개 워크스페이스
무제한 개인 워크스페이스
월 1,000회 목 서버 호출
월 1,000회 모니터링 호출
클라우드 러너 기준 월 25회 컬렉션 실행

핵심 제한은 다음입니다.

무료 플랜에서는 팀원을 비공개 워크스페이스에 초대할 수 없습니다.

비공개 워크스페이스에서 여러 사용자가 함께 작업하려면 최소 Basic 플랜이 필요하며, 비용은 월 사용자당 19달러입니다.

방법 1: 컬렉션을 JSON으로 내보내고 파일 공유

가장 단순한 방법은 Postman 컬렉션을 JSON 파일로 내보내 팀원에게 전달하는 것입니다.

실행 절차

Postman을 엽니다.
왼쪽 사이드바에서 공유할 컬렉션을 선택합니다.
컬렉션 이름 옆의 ... 메뉴를 클릭합니다.
Export를 선택합니다.
Collection v2.1 형식을 선택합니다.
JSON 파일을 저장합니다.
이메일, Slack, Google Drive, GitHub 등으로 팀원에게 전달합니다.

팀원은 다음 방식으로 가져올 수 있습니다.

File > Import > JSON 파일 선택 또는 드래그 앤 드롭

장점

Postman 유료 플랜이 필요 없습니다.
설정이 빠릅니다.
일회성 전달에는 충분합니다.
Postman 계정 없이도 Collection v2.1을 지원하는 도구에서 가져올 수 있습니다.

단점

JSON 파일은 내보낸 시점의 스냅샷입니다.

예를 들어 원본 컬렉션에 다음 변경이 생겨도 팀원에게 자동 반영되지 않습니다.

새 엔드포인트 추가
요청 URL 수정
헤더 변경
테스트 스크립트 수정
인증 방식 변경

또한 환경 변수는 기본적으로 컬렉션과 함께 이동하지 않습니다. 환경은 별도로 내보내야 합니다.

Environments > 환경 선택 > ... > Export

즉, 실제 공유 시에는 보통 다음 두 파일을 함께 전달해야 합니다.

my-api.postman_collection.json
dev.postman_environment.json

이 방법은 컬렉션이 자주 바뀌지 않는 경우에는 괜찮습니다. 하지만 활발히 개발 중인 API에는 적합하지 않습니다.

방법 2: 공개 워크스페이스 사용

Postman 무료 플랜에서는 공개 워크스페이스를 만들 수 있습니다. 공개 워크스페이스에 컬렉션을 올리면 링크를 가진 사람이 컬렉션을 확인하고 포크할 수 있습니다.

설정 절차

Postman에서 새 워크스페이스를 생성합니다.
공개 범위에서 Public을 선택합니다.
공유할 컬렉션을 공개 워크스페이스에 추가합니다.
워크스페이스 URL을 팀원에게 전달합니다.
팀원은 컬렉션을 자신의 워크스페이스로 포크합니다.

장점

무료 플랜에서 사용할 수 있습니다.
링크 공유가 쉽습니다.
공개 API 문서나 오픈 소스 프로젝트에 적합합니다.

단점

공개 워크스페이스는 말 그대로 공개입니다.

다음 정보가 포함되어 있다면 위험합니다.

내부 API URL
스테이징 서버 주소
예시 응답에 포함된 민감한 데이터
인증 토큰
내부 서비스 이름
비공개 엔드포인트 구조

또한 포크된 컬렉션은 자동으로 동기화되지 않습니다. 원본이 변경되면 팀원이 직접 변경 사항을 가져와야 합니다.

공개 워크스페이스는 읽기 중심 공유에는 유용하지만, 내부 팀의 비공개 협업에는 적합하지 않습니다.

방법 3: Git 저장소를 동기화 계층으로 사용

일부 팀은 Postman 컬렉션 JSON을 코드 아티팩트처럼 관리합니다. 컬렉션을 내보낸 뒤 Git 저장소에 커밋하는 방식입니다.

기본 워크플로우

담당자가 Postman 컬렉션을 수정합니다.
변경이 완료되면 컬렉션을 JSON으로 내보냅니다.
JSON 파일을 Git 저장소에 커밋합니다.
팀원은 저장소를 pull 합니다.
최신 JSON을 Postman으로 다시 import 합니다.

예시 구조는 다음과 같습니다.

api/
  postman/
    collection.json
    dev.environment.json
    staging.environment.json

커밋 예시는 다음과 같습니다.

git add api/postman/collection.json
git commit -m "Update user API collection"
git push origin main

장점

변경 이력을 Git으로 추적할 수 있습니다.
단일 저장소에서 컬렉션을 관리할 수 있습니다.
코드 리뷰 프로세스에 포함할 수 있습니다.

단점

가져오기 단계가 매번 필요합니다.

Git pull → Postman import → 기존 컬렉션 덮어쓰기

이 과정에서 팀원이 로컬에서 수정한 내용이 있으면 충돌이 발생하거나 사라질 수 있습니다. JSON 병합도 쉽지 않습니다. 컬렉션 구조가 크면 diff를 읽고 수동으로 병합하는 데 시간이 걸립니다.

또한 누군가가 변경 후 내보내기와 커밋을 잊으면 Git 저장소의 컬렉션은 실제 Postman 상태보다 뒤처집니다.

이 방법은 파일 공유보다 낫지만, 여전히 수동 운영 비용이 큽니다.

방법 4: 하나의 “주” 계정으로 Postman 개인 워크스페이스 사용

일부 소규모 팀은 하나의 Postman 계정을 여러 사람이 공유합니다. 같은 계정으로 여러 컴퓨터에서 로그인해 개인 워크스페이스를 함께 사용하는 방식입니다.

하지만 이 방법은 권장할 수 없습니다.

문제는 다음과 같습니다.

Postman 서비스 약관에 위배될 수 있습니다.
공유 자격 증명이 감지되면 계정이 잠길 수 있습니다.
동기화 충돌이 발생할 수 있습니다.
누가 어떤 변경을 했는지 추적할 수 없습니다.
퇴사자나 외부 협업자에게 접근 권한을 회수하기 어렵습니다.

이 방법은 실제로 일부 팀이 사용하기 때문에 언급하지만, 협업 방식으로는 피하는 것이 좋습니다.

Apidog가 무료 요금제 공유를 처리하는 방법

Apidog는 이 문제를 다른 방식으로 해결합니다.

Apidog 무료 플랜에서는 공유 워크스페이스에 최대 3명의 사용자를 포함할 수 있습니다. 팀원 간 변경 사항은 실시간으로 동기화되므로 JSON 파일을 내보내거나 다시 가져올 필요가 없습니다.

즉, 팀은 다음과 같은 수동 작업을 줄일 수 있습니다.

Postman export
JSON 파일 전달
팀원별 import
환경 파일 별도 전달
변경 사항 재공유

Apidog에서 API 정의를 수정하면 팀원들은 같은 워크스페이스에서 변경 사항을 확인할 수 있습니다. 모두 동일한 진실의 원천을 기준으로 작업합니다.

이미 Postman을 사용 중이라면 기존 컬렉션을 가져올 수도 있습니다. Apidog는 Postman Collection v2.1 형식을 지원합니다.

Postman 컬렉션을 Apidog로 가져오는 기본 흐름

Postman에서 컬렉션을 Collection v2.1 JSON으로 내보냅니다.
Apidog에서 Import를 선택합니다.
내보낸 JSON 파일을 선택합니다.
요청, 헤더, 컬렉션 구조를 확인합니다.
필요한 경우 환경 파일도 함께 가져옵니다.

Apidog 무료 플랜에는 다음 기능도 포함됩니다.

API 디자인 에디터
OpenAPI 3.0 및 Swagger 지원
실제와 유사한 응답을 만드는 Smart Mock
월별 실행 제한이 없는 테스트 러너
API 정의에서 자동 생성되는 문서
로컬 우선 저장소
동기화를 선택하지 않는 한 데이터가 사용자 컴퓨터에 유지됨

2-3명 규모의 팀이라면 Postman의 공유 제한을 우회하기보다, 처음부터 무료 협업을 지원하는 도구를 사용하는 편이 더 단순할 수 있습니다.

상황에 맞는 방법 선택

상황	추천 접근 방식
한 번만 전달하면 됨	JSON 내보내기 및 파일 공유
컬렉션 변경이 거의 없음	JSON 내보내기
오픈 소스 프로젝트	Postman 공개 워크스페이스
민감한 데이터가 없는 공개 API	Postman 공개 워크스페이스
Git 기반 변경 이력이 필요함	Git + JSON 내보내기
개발자 2-3명이 활발히 협업함	Apidog 무료 플랜
비공개 API를 자주 수정함	Apidog 무료 플랜

Postman 무료 플랜의 우회 방법은 모두 사용할 수 있습니다. 하지만 대부분 다음 중 하나의 비용을 지불하게 됩니다.

보안 위험
수동 동기화
오래된 컬렉션
환경 변수 누락
병합 충돌
반복적인 import/export 작업

API가 자주 바뀌는 팀이라면 이 마찰이 빠르게 누적됩니다.

자주 묻는 질문

계정 없이 Postman 컬렉션을 공유할 수 있나요?

네. 컬렉션을 JSON 파일로 내보내 직접 전달할 수 있습니다. 수신자는 Postman Collection v2.1 형식을 지원하는 API 클라이언트에서 가져올 수 있습니다.

Postman Basic 플랜은 팀 공유를 허용하나요?

네. 월 사용자당 19달러의 Basic 플랜에서는 여러 사용자가 비공개 워크스페이스에서 협업할 수 있습니다. 무료 플랜에서는 비공개 워크스페이스에 팀원을 초대할 수 없습니다.

Postman 공개 워크스페이스란 무엇인가요?

공개 워크스페이스는 인터넷상의 누구나 볼 수 있는 워크스페이스입니다. 방문자는 컬렉션을 보고 포크할 수 있지만 원본을 직접 편집할 수는 없습니다. 무료 플랜에서는 최대 3개의 공개 워크스페이스를 만들 수 있습니다.

환경 변수도 컬렉션과 함께 내보내지나요?

아니요. 환경 변수는 별도로 내보내야 합니다.

절차는 다음과 같습니다.

Environments > 환경 선택 > ... > Export

공유 시에는 컬렉션 JSON과 환경 JSON을 함께 전달하는 것이 좋습니다.

Apidog 무료 플랜에서 몇 명이 워크스페이스를 공유할 수 있나요?

Apidog 무료 플랜은 신용카드 없이 최대 3명의 사용자가 공유 워크스페이스에서 협업할 수 있도록 지원합니다.

기존 Postman 컬렉션을 Apidog로 가져올 수 있나요?

네. Apidog는 Postman Collection v2.1 JSON 파일 가져오기를 지원합니다. Apidog에서 Import를 선택하고 JSON 파일을 업로드하면 기존 컬렉션을 가져올 수 있습니다.

마무리

Postman 무료 요금제의 공유 제한은 실제 개발 워크플로우에 영향을 줍니다. JSON 내보내기, 공개 워크스페이스, Git 저장소 활용은 모두 가능한 방법이지만, 지속적인 협업에는 수동 작업과 위험이 따릅니다.

API를 활발히 개발하는 2-3명 팀이라면, 우회 방법을 계속 관리하는 대신 무료 플랜에서 공유 워크스페이스를 지원하는 도구를 사용하는 것이 더 효율적입니다.

DEV Community