Postman 컬렉션 잠겼을 때 복구하는 방법

핵심 요약 (TL;DR)

Postman 무료 플랜 변경으로 인해 공유 컬렉션에 대한 접근 권한이 상실되었다면, 데이터가 반드시 사라진 것은 아니지만 로컬 캐시가 지워지기 전에 신속하게 조치해야 합니다. 이 가이드는 로컬 앱 캐시, 내보내기 파일, 팀 관리자 복구 등 사용 가능한 모든 복구 경로를 안내하며, 복구한 데이터를 Apidog로 마이그레이션하여 다시는 이런 상황에 처하지 않도록 하는 방법을 보여줍니다.

버튼

서론

불만이 빠르게 터져 나왔습니다. Postman의 2026년 1분기 무료 티어 업데이트 이후, 동료들과 워크스페이스를 공유해왔던 개발자들은 접근이 차단된 자신들을 발견했습니다. 공유 워크스페이스는 접근 불가능하게 되었습니다. 개인 워크스페이스가 아닌 팀 워크스페이스에 존재하던 컬렉션들은 갑자기 유료화되었습니다.

한 개발자는 Reddit에 다음과 같이 설명했습니다. "월요일에 출근했더니 팀 워크스페이스 전체가 사라졌습니다. 3개월 동안 정리했던 컬렉션, 환경 등 모든 것이요. 돈을 내지 않으면 그냥 사라진 거죠."

답답한 점은 데이터가 실제로 삭제된 것이 아니라는 것입니다. Postman의 아키텍처는 워크스페이스 데이터를 서버 측에 보관하며, 잠금은 삭제가 아닌 접근 제한입니다. 하지만 이 차이점은 캐시가 만료되거나 워크스페이스가 정리되기 전에 이를 해결하는 방법을 아는 경우에만 의미가 있습니다.

먼저 Postman 데스크톱 앱 캐시를 확인하세요

다른 어떤 조치를 취하기 전에, Postman 데스크톱 앱이 설치되어 있다면 실행하세요. 웹 버전은 실행하지 마세요.

데스크톱 앱은 최근에 접근했던 컬렉션과 환경의 로컬 캐시를 저장합니다. 서버 측 접근 권한이 취소되었더라도, 캐시에는 시스템 및 Postman이 캐시 무효화를 관리하는 방식에 따라 일반적으로 며칠에서 일주일 정도의 짧은 기간 동안 컬렉션 데이터가 남아있을 수 있습니다.

확인 단계:

Postman 데스크톱 앱을 엽니다 (app.getpostman.com의 웹 앱이 아님).
히스토리 탭에서 최근 요청을 확인하세요. 이 요청들은 전체 컬렉션 구조를 포함하지 않지만, 작업 중이던 엔드포인트를 확인할 수 있습니다.
컬렉션이 왼쪽 사이드바에 여전히 표시되는지 확인하세요. 표시된다면 즉시 내보내기하세요.

사이드바에서 내보내려면: 컬렉션에서 마우스 오른쪽 버튼을 클릭하거나 점 세 개 메뉴를 클릭한 다음 "내보내기(Export)"를 선택하고 컬렉션 v2.1로 저장하세요. 여전히 보이는 모든 컬렉션에 대해 이 작업을 수행하세요.

컬렉션이 표시되지만 내보내기를 시도할 때 오류가 발생하면 오프라인으로 작업해 보세요. Postman에서 오른쪽 상단으로 이동하여 아바타를 클릭한 다음 "오프라인으로 전환(Go Offline)"을 선택하세요. 앱은 서버와 동기화하려는 시도를 중단하고, 캐시된 데이터에 대한 읽기 액세스를 제공하여 내보내기에 충분한 시간을 벌 수 있습니다.

기존 내보내기 파일을 찾아보세요

많은 개발자가 백업 또는 동료와의 공유를 위해 Postman 컬렉션을 주기적으로 내보냅니다. 모든 것이 사라졌다고 가정하기 전에 다음 위치들을 확인해 보세요.

다운로드 폴더. .json 파일을 검색하세요. Postman 컬렉션 내보내기는 최상위 레벨에 "collection" 키를 포함하는 인식 가능한 구조의 JSON 형식을 사용합니다.

프로젝트의 Git 저장소. 일부 팀은 코드베이스와 함께 Postman 컬렉션 JSON 파일을 커밋합니다. 컬렉션처럼 보이는 .json 파일이 있는지 이전 커밋을 포함한 저장소 기록을 확인하세요.

이메일. 동료가 파일을 내보내고 이메일로 보내서 컬렉션을 공유한 적이 있다면, 이메일에서 .json 첨부 파일을 확인하세요.

공유 드라이브. Dropbox, Google Drive 또는 팀이 사용하는 공유 폴더를 확인하세요. 누군가 모두에게 알리지 않고 컬렉션 백업을 내보냈을 수도 있습니다.

CI/CD 파이프라인 파일. 팀이 CI 파이프라인(Jenkins, GitHub Actions, CircleCI)에서 Postman의 Newman CLI 러너를 사용했다면, 컬렉션 JSON은 저장소에 체크인되거나 파이프라인 아티팩트로 저장되었을 가능성이 높습니다. 컬렉션 파일을 참조하는 .yml 또는 .json 파이프라인 구성 파일을 확인하세요.

워크스페이스 소유자 또는 관리자에게 문의하세요

다른 사람의 팀 워크스페이스 멤버였다면, 워크스페이스 소유자가 해당 계정의 유일한 사용자이거나 유료 플랜으로 업그레이드했다면 여전히 모든 접근 권한을 가지고 있을 수 있습니다.

워크스페이스 소유자에게 직접 연락하여 다음을 요청하세요:

Postman 계정에 로그인합니다.
공유했던 워크스페이스로 이동합니다.
점 세 개 메뉴를 통해 각 컬렉션을 내보냅니다.
내보낸 JSON 파일을 보내달라고 요청합니다.

소유자의 계정 또한 다운그레이드되거나 접근 불가능하다면, 팀원 중 누군가가 워크스페이스의 컬렉션을 로컬에 캐시했는지 확인하세요 (이전 섹션의 단계를 사용하여).

Postman API를 사용하여 데이터를 가져오세요

여전히 API 접근 권한이 있다면 (읽기 전용이라도), Postman API를 통해 접근 기간이 끝나기 전에 컬렉션과 환경을 프로그래밍 방식으로 내보낼 수 있습니다.

유효한 Postman API 키가 필요합니다. 플랜 변경 전에 가지고 있던 키가 아직 있다면:

컬렉션 목록 가져오기:

GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY

그런 다음 ID별로 각 컬렉션을 가져오세요:

GET https://api.getpostman.com/collections/{collection_id}
x-api-key: YOUR_POSTMAN_API_KEY

응답 본문에는 JSON 형식의 전체 컬렉션이 포함되어 있습니다. 각각을 .json 파일로 저장하세요.

환경의 경우:

GET https://api.getpostman.com/environments
GET https://api.getpostman.com/environments/{environment_id}

이 방법은 API 키가 여전히 활성 상태인 한 작동합니다. UI 접근 권한이 취소된 후에도 API 키 접근은 잠시 유지될 수 있지만, 오래 지속될 것이라고 기대하지 마세요. 가능한 한 빨리 이 요청들을 실행하세요.

API 키가 저장되어 있지 않다면, 프로젝트의 .env 파일, CI/CD 환경 변수 설정 또는 비밀번호 관리자를 확인하세요.

브라우저 네트워크 로그 또는 서버 로그에서 재구성

위에 제시된 어떤 옵션도 작동하지 않고, 내보내기 파일이나 캐시도 전혀 없다면, 다른 소스에서 컬렉션을 부분적으로 재구성할 수 있을지도 모릅니다.

브라우저 네트워크 로그. 최근에 Postman 웹 앱을 사용했다면, 브라우저가 응답을 캐시했을 수 있습니다. Chrome에서 개발자 도구(F12)를 연 다음, 애플리케이션(Application) > 캐시 저장소(Cache Storage)로 이동하세요. 캐시된 Postman API 응답이 있는지 찾아보세요. 이것이 완전한 구조화된 컬렉션을 포함할 가능성은 낮지만, 요청 세부 정보를 가지고 있을 수 있습니다.

서버 접근 로그. 팀이 Postman이 테스트하던 API를 실행했다면, 서버 접근 로그에는 호출된 모든 엔드포인트가 메서드, 경로, 때로는 헤더와 함께 표시됩니다. 이는 요청 본문이나 테스트 스크립트를 제공하지는 않지만, 컬렉션 구성을 재구성할 수 있는 엔드포인트 구조를 제공합니다.

OpenAPI/Swagger 사양. API에 OpenAPI 사양(a swagger.json 또는 openapi.yaml 파일)이 있다면, Apidog 또는 다른 도구로 직접 가져와 문서화된 엔드포인트, 매개변수 및 응답 스키마와 함께 컬렉션 구조를 재구성할 수 있습니다.

복구된 컬렉션을 Apidog로 가져오기

컬렉션 JSON 파일이 준비되면, Apidog로 가져오는 데 약 2분이면 됩니다.

Apidog 데스크톱 앱을 다운로드하여 설치하거나 웹 버전을 엽니다.
새 프로젝트를 생성합니다.
프로젝트에서 왼쪽 사이드바의 "가져오기(Import)"를 클릭합니다.
가져오기 소스로 "Postman"을 선택합니다.
컬렉션 JSON 파일을 업로드합니다.
각 컬렉션에 대해 반복합니다.

환경의 경우: 동일한 가져오기 흐름을 사용하여 "Postman Environment"를 소스 유형으로 선택하고 별도로 가져옵니다.

가져오기 후 팀원을 초대하세요. Apidog 무료 플랜에서는 최대 3명의 사용자가 워크스페이스를 공유할 수 있습니다. 컬렉션은 좌석별 요금 없이 모든 팀원에게 동기화됩니다.

다시는 이런 일이 발생하지 않도록 예방

핵심 문제는 Postman이 컬렉션을 서버 측에 저장하고 요금 청구를 통해 접근을 제한했다는 것입니다. 데이터를 로컬에 보관하거나 명확한 내보내기 소유권을 제공하는 도구를 선택함으로써 이 문제를 완전히 피할 수 있습니다.

Apidog는 기본적으로 컬렉션을 로컬에 저장합니다. 클라우드 동기화는 선택 사항이며 필수가 아닙니다. 요금 변경이 발생하더라도 데이터는 이미 사용자 컴퓨터에 있습니다.

앞으로 어떤 도구를 사용하든, 정기적인 내보내기 습관을 들이세요:

각 스프린트가 끝날 때마다 컬렉션을 JSON으로 내보내기하세요.
코드베이스와 함께 컬렉션 JSON 파일을 Git 저장소에 커밋하세요.
환경 파일(비밀 정보는 제거된 상태로)을 저장소의 개발 문서에 보관하세요.

이러한 습관은 설정하는 데 5분밖에 걸리지 않으며, "접근 차단" 시나리오를 완전히 없애줍니다.

버튼

경고 없이 의존하는 도구에 대한 접근 권한을 잃는 것은 답답한 경험이며, Postman 무료 티어 변경은 많은 팀을 당황하게 만들었습니다. 좋은 소식은 신속하게 움직이고 제시된 옵션들을 순서대로 따르면 대부분의 데이터를 복구할 수 있다는 것입니다. 컬렉션을 내보내어 다시 안정화되면, 데이터를 로컬에 보관하는 도구로 마이그레이션하는 것은 장기적으로 훨씬 더 나은 위치에 놓이게 할 것입니다.