TL;DR (요약)
Postman의 무료 요금제는 컬렉션 공유에 제한이 있어 많은 개발자를 당황하게 합니다. 월 사용자당 19달러를 지불하지 않고 팀원들과 협업해야 한다면 몇 가지 해결 방법이 있지만, 각각 실제적인 단점이 있습니다. Apidog의 무료 플랜은 업그레이드 없이 최대 3명의 사용자와 워크스페이스를 공유할 수 있도록 해줍니다.
서론
Postman은 HTTP 요청을 보내는 간단한 Chrome 확장 프로그램으로 시작했습니다. 수년에 걸쳐 완전한 기능을 갖춘 API 플랫폼으로 성장했으며, 가격도 함께 올랐습니다. 오늘날 컬렉션을 공유하고 실시간으로 협업하려는 팀은 유료 플랜이 필요합니다. 무료 요금제는 많은 개발자에게 해결 방법을 찾도록 만듭니다.
소규모 팀, 사이드 프로젝트 또는 모든 돈이 중요한 스타트업을 운영하는 경우, 단순히 컬렉션을 공유하기 위해 사용자당 월 19달러를 지불하는 것은 부담스럽게 느껴질 수 있습니다. 이는 단 하나의 기능을 출시하기도 전에 개인당 연간 228달러입니다.
다행히도 무료 플랜에서 Postman 컬렉션을 공유할 수 있는 합법적인 방법이 있습니다. 팀 플랜에 비용을 지불하는 것만큼 원활하지는 않지만, 작동합니다. 이 가이드는 각 방법을 안내하고, 무엇이 문제인지 설명하며, 진정한 무료 대안이 무엇인지 보여줍니다.
Postman의 무료 플랜이 실제로 허용하는 것
해결 방법을 살펴보기 전에 2024-2025년 기준 무료 플랜에 무엇이 포함되어 있는지 이해하는 것이 도움이 됩니다.
Postman의 무료 플랜은 다음을 제공합니다:
- 워크스페이스당 사용자 1명 (공유 편집 불가)
- 최대 3개의 활성 공개 워크스페이스
- 무제한 개인 워크스페이스
- 월 1,000회 목 서버 호출
- 월 1,000회 모니터링 호출
- 클라우드 러너에서 월 25회로 제한되는 컬렉션 실행
치명적인 제한 사항: 무료 플랜에서는 팀원을 비공개 워크스페이스에 초대할 수 없습니다. 비공개 워크스페이스는 월 사용자당 19달러의 최소 Basic 플랜이 필요합니다. 이것이 대부분의 소규모 팀이 가장 먼저 직면하는 장벽입니다.
방법 1: 컬렉션을 JSON으로 내보내고 파일 공유
가장 직접적인 해결 방법은 컬렉션을 JSON 파일로 내보내 팀원에게 보내는 것입니다.
방법:
- Postman을 열고 왼쪽 사이드바에서 컬렉션으로 이동합니다.
- 컬렉션 이름 옆의 세 점 메뉴를 클릭합니다.
- "내보내기(Export)"를 선택합니다.
- Collection v2.1 형식(현재 표준이며 가장 넓은 호환성을 가짐)을 선택합니다.
- JSON 파일을 저장하고 이메일, Slack 또는 공유 드라이브를 통해 공유합니다.
팀원은 파일 > 가져오기(File > Import)로 이동하여 JSON 파일을 드래그하여 가져올 수 있습니다.
문제점:
내보내는 순간 컬렉션은 스냅샷이 됩니다. 새 엔드포인트를 추가하거나 요청을 수정하더라도 팀원은 이를 알 수 없습니다. 그들은 오래된 복사본으로 작업하게 됩니다.
환경 변수는 기본적으로 컬렉션과 함께 이동하지 않습니다. 환경을 별도로 내보내야 하며, 팀원도 이를 가져와야 합니다. 변수 하나를 잊어버리면 요청이 실패하고, 실제로 고장나지 않은 것을 디버깅하는 데 시간을 보내게 됩니다.
병합 워크플로우가 없습니다. 두 사람이 동시에 로컬 복사본을 편집한 다음 이를 조정하려고 하면 수동으로 처리해야 합니다.
이 방법은 가끔 한 번 전달하는 경우에 작동합니다. 컬렉션이 활발하게 변경되는 경우 빠르게 무용지물이 됩니다.
방법 2: 공개 워크스페이스 사용
Postman은 무료 플랜에서 공개 워크스페이스를 생성할 수 있도록 합니다. 링크를 가진 누구든지 컬렉션을 보고 포크할 수 있습니다.
설정 방법:
- Postman에서 새 워크스페이스를 생성합니다.
- 공개 범위(visibility)를 선택하라는 메시지가 표시되면 "공개(Public)"를 선택합니다.
- 컬렉션을 공개 워크스페이스에 추가합니다.
- 워크스페이스 URL을 팀원들과 공유합니다.
팀원들은 컬렉션을 자신의 워크스페이스로 포크하여 작업할 수 있습니다.
문제점:
공개는 말 그대로 공개입니다. URL을 알거나 Postman의 공개 API 네트워크를 검색하면 인터넷상의 누구든지 컬렉션을 찾아볼 수 있습니다. 내부 도구, 스테이징 환경 또는 예시 응답에 인증 토큰이 포함된 모든 것에 대해서는 상당한 위험이 있습니다.
포크된 컬렉션은 자동으로 동기화되지 않습니다. 원본을 업데이트하면 팀원은 변경 사항을 수동으로 자신의 포크로 가져와야 합니다. 변경 사항이 발생했다는 알림도 없습니다.
댓글 및 직접 협업은 여전히 팀 플랜이 필요합니다. 공개 워크스페이스는 뷰어에게 읽기 전용입니다. 원본을 편집할 수 없습니다.
이 방법은 오픈 소스 프로젝트나 공개 API 문서에 잘 작동합니다. 내부 팀 워크플로우에는 적합하지 않습니다.
방법 3: Git 저장소를 동기화 계층으로 사용
일부 팀은 내보낸 JSON을 코드 아티팩트로 취급하고 Git 저장소에 커밋하여 동기화 문제를 해결합니다.
워크플로우는 다음과 같습니다:
- 한 사람이 Postman 컬렉션을 소유하고 의미 있는 변경 사항이 있을 때마다 내보냅니다.
- 업데이트된 JSON을 공유 Git 저장소(GitHub, GitLab, Bitbucket)에 커밋합니다.
- 팀원들은 최신 버전을 가져와 자신의 로컬 Postman으로 가져옵니다.
문제점:
가져오기(import)를 할 때마다 기존 로컬 컬렉션을 덮어씁니다. 팀원이 로컬에서 변경한 내용이 있다면, 먼저 내보내고 병합하지 않는 한 해당 변경 사항은 사라집니다.
이 워크플로우는 규율이 필요합니다. 누군가는 변경 사항이 있을 때마다 내보내고 커밋하는 것을 기억해야 합니다. 실제로는 Git 버전이 거의 항상 실제 Postman 상태보다 뒤처집니다.
Git 저장소에서 직접 요청을 실행할 수 없습니다. 누군가는 항상 가져오기(import) 단계를 수행해야 하며, 이는 시간이 걸리고 마찰을 일으킵니다.
이 방법은 기록과 단일 진실의 원천을 제공하므로 일반 파일 공유보다 낫지만, 수동 단계가 오버헤드를 추가하여 팀의 속도를 늦춥니다.
방법 4: 하나의 "주" 계정으로 Postman의 무료 개인 워크스페이스 사용
일부 소규모 팀은 모든 사람이 하나의 Postman 계정을 공유하도록 하여 협업 제한을 해결합니다. 한 사람이 동일한 자격 증명으로 여러 컴퓨터에서 로그인합니다.
이는 Postman의 서비스 약관에 위배되며 다음과 같은 실제적인 문제를 야기합니다:
- Postman은 공유된 자격 증명을 감지하고 계정을 잠글 수 있습니다.
- 동기화 충돌이 발생하면 한 사람이 변경한 내용이 다른 사람이 변경한 내용을 덮어쓸 수 있습니다.
- 특정 사람에게 변경 사항을 귀속시킬 방법이 없습니다.
이 방법은 좋은 생각이라서가 아니라 팀에서 실제로 사용하기 때문에 여기에 언급되었습니다.
Apidog가 무료 요금제 공유를 처리하는 방법
Apidog는 협업 문제에 다른 접근 방식을 취합니다. 무료 플랜에는 공유 워크스페이스에서 최대 3명의 팀원이 포함되며, 모든 팀원 간에 실시간 동기화가 이루어집니다. 해결 방법이나 JSON 파일 이동이 필요 없습니다.
Apidog에서 API 정의를 변경하면 팀원들은 즉시 이를 확인합니다. 누구도 아무것도 내보내거나 가져올 필요 없이 모두 동일한 진실의 원천에서 작업합니다.
이미 Postman을 사용하고 있다면 기존 컬렉션을 직접 가져올 수 있습니다. Apidog는 Postman Collection v2.1 형식을 읽으므로, 전환은 주말 프로젝트가 아닌 한 번의 클릭으로 가능합니다.
무료 플랜에는 다음도 포함됩니다:
- 전체 API 디자인 에디터 (OpenAPI 3.0 및 Swagger)
- 클라우드 종속성 없이 실제와 같은 응답을 생성하는 Smart Mock
- 월별 실행 제한이 없는 테스트 러너
- 정의에서 자동으로 생성되는 API 문서
- 로컬 우선 저장소로, 동기화를 선택하지 않는 한 데이터가 사용자 컴퓨터에 유지됩니다.
2-3명으로 구성된 팀의 경우, Apidog 무료 플랜은 Postman의 팀 플랜과 동일한 내용을 비용 없이 제공합니다.
상황에 맞는 올바른 방법 선택
다음은 빠른 의사 결정 가이드입니다:
| 상황 | 최적의 접근 방식 |
|---|---|
| 한 번의 전달, 컬렉션이 안정적임 | JSON 내보내기 및 파일 공유 |
| 오픈 소스 프로젝트, 민감한 데이터 없음 | Postman 공개 워크스페이스 |
| 개발자 팀, 활발한 개발 | Apidog 무료 플랜 |
| 이미 Git 사용 중, 버전 기록 원함 | Git + JSON 내보내기 워크플로우 |
팀이 API를 활발히 구축하고 있고 Postman의 공유 제한에 부딪히고 있다면, JSON 및 Git 해결 방법은 속도를 늦출 것입니다. 이들은 당장의 문제를 해결하지만 지속적인 마찰을 추가합니다.
자주 묻는 질문
계정 없이 Postman 컬렉션을 공유할 수 있나요?네. 컬렉션을 JSON 파일로 내보내어 파일을 직접 전송할 수 있습니다. 수신자는 Apidog를 포함하여 Postman Collection v2.1 형식을 지원하는 API 클라이언트를 사용하는 경우 Postman 계정 없이도 가져올 수 있습니다.
Postman Basic 플랜은 팀 공유를 허용하나요?네. 월 사용자당 19달러의 Basic 플랜은 여러 사용자와의 비공개 워크스페이스 협업을 허용합니다. 무료 플랜은 그렇지 않습니다.
Postman 공개 워크스페이스란 무엇인가요?공개 워크스페이스는 인터넷상의 누구에게나 보입니다. 방문자는 컬렉션을 보고 포크할 수 있지만 원본을 편집할 수는 없습니다. 무료 플랜에서는 최대 3개의 공개 워크스페이스를 무료로 생성할 수 있습니다.
환경 변수가 컬렉션과 함께 내보내지나요?아니요. 환경 변수는 별도로 내보내집니다. 사이드바의 환경(Environments)으로 이동하여 필요한 환경의 세 점 메뉴를 클릭하고 별도의 JSON 파일로 내보내세요. 두 파일을 팀원과 공유하세요.
Apidog의 무료 플랜에서 몇 명의 사용자가 워크스페이스를 공유할 수 있나요?Apidog의 무료 플랜은 신용카드 없이 실시간 동기화가 되는 공유 워크스페이스에서 최대 3명의 사용자를 지원합니다.
기존 Postman 컬렉션을 Apidog로 가져올 수 있나요?네. Apidog는 Postman Collection v2.1 JSON 파일의 직접 가져오기를 지원합니다. Apidog에서 가져오기(Import)로 이동하여 파일을 선택하면 요청, 헤더 및 환경 변수가 손상되지 않은 상태로 컬렉션이 가져와집니다.
Postman 무료 요금제의 공유 제한은 실제적이며, 해결 방법은 시간과 신뢰성 면에서 실제 비용이 발생합니다. 실제 협업이 필요한 최대 3명으로 구성된 팀의 경우, 지속적인 수동 작업이 필요한 워크플로우를 땜질하는 것보다 무료 요금제 공유를 위해 구축된 도구로 전환하는 것이 더 깔끔한 경우가 많습니다.