DEV Community

Cover image for Postman 컬렉션 잠겼을 때 복구하는 방법
Rihpig
Rihpig

Posted on • Originally published at apidog.com

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

핵심 요약 (TL;DR)

Postman 무료 플랜 변경으로 공유 컬렉션 접근 권한을 잃었다면, 데이터가 반드시 삭제된 것은 아닙니다. 다만 로컬 캐시가 지워지기 전에 빠르게 확인해야 합니다. 아래 순서대로 Postman 데스크톱 캐시, 기존 내보내기 파일, 워크스페이스 관리자, Postman API를 점검하고, 복구한 컬렉션은 Apidog로 가져와 재발을 줄이세요.

지금 Apidog를 사용해 보세요

서론

Postman의 2026년 1분기 무료 티어 업데이트 이후, 팀 워크스페이스를 공유하던 개발자들이 갑자기 접근 차단을 경험했습니다. 개인 워크스페이스가 아닌 팀 워크스페이스에 있던 컬렉션과 환경이 유료 플랜 뒤로 잠기면서, 작업 중이던 API 요청을 바로 열 수 없게 된 것입니다.

한 개발자는 Reddit에 이렇게 설명했습니다.

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

중요한 점은 데이터가 실제로 삭제된 것이 아닐 수 있다는 것입니다. Postman은 워크스페이스 데이터를 서버 측에 보관하며, 이번 문제는 삭제라기보다 접근 제한에 가깝습니다. 하지만 캐시가 만료되거나 워크스페이스 상태가 변경되기 전에 조치해야 복구 가능성이 높습니다.

아래 순서대로 확인하세요.

1. Postman 데스크톱 앱 캐시부터 확인하세요

가장 먼저 해야 할 일은 Postman 데스크톱 앱을 여는 것입니다. 웹 앱이 아니라 로컬에 설치된 데스크톱 앱을 사용하세요.

데스크톱 앱은 최근 접근한 컬렉션과 환경 데이터를 로컬 캐시에 저장할 수 있습니다. 서버 측 접근 권한이 사라졌더라도, 시스템 상태와 Postman의 캐시 무효화 방식에 따라 며칠에서 약 일주일 정도 캐시가 남아 있을 수 있습니다.

확인 절차

  1. Postman 데스크톱 앱을 엽니다. app.getpostman.com 웹 앱이 아닙니다.
  2. History 탭에서 최근 요청을 확인합니다.
  3. 왼쪽 사이드바에 컬렉션이 여전히 표시되는지 확인합니다.
  4. 컬렉션이 보이면 즉시 내보냅니다.

컬렉션 내보내기

사이드바에서 컬렉션을 내보내려면:

  1. 컬렉션을 우클릭하거나 점 세 개 메뉴를 클릭합니다.
  2. Export를 선택합니다.
  3. 포맷은 Collection v2.1로 저장합니다.
  4. 보이는 모든 컬렉션에 대해 반복합니다.

내보내기 오류가 발생하는 경우

컬렉션은 보이지만 내보내기 중 오류가 발생한다면, 오프라인 모드로 전환해 보세요.

  1. Postman 오른쪽 상단의 아바타를 클릭합니다.
  2. Go Offline을 선택합니다.
  3. 서버 동기화 시도를 중단한 상태에서 다시 내보내기를 시도합니다.

오프라인 모드에서는 캐시된 데이터에 대한 읽기 접근이 유지될 수 있어, 내보내기에 필요한 시간을 벌 수 있습니다.

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

팀이나 개인이 이전에 Postman 컬렉션을 내보낸 적이 있을 수 있습니다. 모든 데이터가 사라졌다고 판단하기 전에 아래 위치를 확인하세요.

다운로드 폴더

.json 파일을 검색하세요.

Postman 컬렉션 내보내기 파일은 일반적으로 JSON이며, 최상위 구조에 "collection" 키가 포함됩니다.

예:

{
  "collection": {
    "info": {
      "name": "Example API"
    },
    "item": []
  }
}
Enter fullscreen mode Exit fullscreen mode

Git 저장소

일부 팀은 Postman 컬렉션 JSON을 코드베이스와 함께 커밋합니다.

확인할 위치:

  • 프로젝트 루트
  • docs/
  • postman/
  • collections/
  • 이전 커밋 기록
  • 삭제된 파일 기록

예시 명령어:

git log --all -- '*.json'
Enter fullscreen mode Exit fullscreen mode

파일명에 postman, collection, api 등이 포함되어 있는지도 확인하세요.

find . -iname "*postman*.json" -o -iname "*collection*.json"
Enter fullscreen mode Exit fullscreen mode

이메일

동료가 컬렉션을 이메일로 공유한 적이 있다면 .json 첨부 파일을 검색하세요.

검색 키워드 예:

Postman
collection
environment
.json
Enter fullscreen mode Exit fullscreen mode

공유 드라이브

다음 위치도 확인하세요.

  • Google Drive
  • Dropbox
  • OneDrive
  • 팀 공유 폴더
  • 사내 위키 첨부 파일

누군가 백업용으로 내보내 둔 파일이 있을 수 있습니다.

CI/CD 파이프라인

팀이 Newman CLI로 Postman 컬렉션을 실행했다면, 컬렉션 JSON이 저장소나 파이프라인 아티팩트에 있을 가능성이 높습니다.

확인할 파일:

  • .github/workflows/*.yml
  • Jenkinsfile
  • .circleci/config.yml
  • GitLab CI 설정 파일
  • Newman 실행 스크립트

예:

grep -R "newman" .
grep -R "collection" .
Enter fullscreen mode Exit fullscreen mode

3. 워크스페이스 소유자 또는 관리자에게 요청하세요

본인이 팀 워크스페이스의 멤버였고, 다른 사람이 소유자라면 해당 소유자는 여전히 접근 권한을 가지고 있을 수 있습니다.

워크스페이스 소유자에게 다음 작업을 요청하세요.

  1. Postman 계정에 로그인합니다.
  2. 공유했던 워크스페이스로 이동합니다.
  3. 각 컬렉션의 점 세 개 메뉴를 클릭합니다.
  4. Export를 선택합니다.
  5. 내보낸 JSON 파일을 팀에 공유합니다.

소유자 계정도 다운그레이드되었거나 접근할 수 없다면, 팀원 중 누군가의 로컬 Postman 데스크톱 앱에 캐시가 남아 있는지 확인하세요. 이 경우 1번 섹션의 절차를 그대로 적용하면 됩니다.

4. Postman API로 컬렉션과 환경을 가져오세요

UI 접근은 제한되었지만 API 키가 아직 활성 상태라면, Postman API를 통해 컬렉션과 환경을 프로그래밍 방식으로 내보낼 수 있습니다.

먼저 기존 Postman API 키를 찾으세요.

확인할 위치:

  • 비밀번호 관리자
  • .env 파일
  • CI/CD 환경 변수
  • 팀 문서
  • 로컬 셸 설정 파일

예:

grep -R "POSTMAN" .
grep -R "postman" .
Enter fullscreen mode Exit fullscreen mode

컬렉션 목록 가져오기 

GET https://api.getpostman.com/collections
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

curl 예시:

curl -H "x-api-key: YOUR_POSTMAN_API_KEY" \
  https://api.getpostman.com/collections
Enter fullscreen mode Exit fullscreen mode

응답에서 컬렉션 ID를 확인한 뒤, 각 컬렉션을 개별로 가져옵니다.

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

curl 예시:

curl -H "x-api-key: YOUR_POSTMAN_API_KEY" \
  https://api.getpostman.com/collections/{collection_id} \
  -o collection-{collection_id}.json
Enter fullscreen mode Exit fullscreen mode

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

환경 목록 가져오기 

GET https://api.getpostman.com/environments
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

환경 상세 가져오기:

GET https://api.getpostman.com/environments/{environment_id}
x-api-key: YOUR_POSTMAN_API_KEY
Enter fullscreen mode Exit fullscreen mode

curl 예시:

curl -H "x-api-key: YOUR_POSTMAN_API_KEY" \
  https://api.getpostman.com/environments/{environment_id} \
  -o environment-{environment_id}.json
Enter fullscreen mode Exit fullscreen mode

이 방법은 API 키가 여전히 활성 상태일 때만 작동합니다. UI 접근이 취소된 뒤에도 API 키 접근이 잠시 유지될 수 있지만, 오래 지속된다고 기대하지 않는 것이 좋습니다. 가능한 한 빨리 실행하세요.

5. 브라우저 네트워크 로그 또는 서버 로그에서 재구성하세요

캐시, 내보내기 파일, 관리자 접근, API 키가 모두 없다면 컬렉션 전체 복구는 어렵습니다. 그래도 일부 요청 구조는 다른 소스에서 재구성할 수 있습니다.

브라우저 캐시 확인

최근 Postman 웹 앱을 사용했다면 브라우저가 일부 응답을 캐시했을 수 있습니다.

Chrome 기준:

  1. 개발자 도구를 엽니다. F12 또는 Cmd + Option + I
  2. Application 탭으로 이동합니다.
  3. Cache Storage를 확인합니다.
  4. Postman 관련 캐시 응답이 있는지 찾습니다.

완전한 컬렉션 구조가 들어 있을 가능성은 낮지만, 요청 URL이나 일부 메타데이터를 찾는 데 도움이 될 수 있습니다.

서버 접근 로그 확인

팀이 Postman으로 테스트하던 API 서버를 직접 운영하고 있다면, 서버 접근 로그에서 호출된 엔드포인트를 확인할 수 있습니다.

확인 가능한 정보:

  • HTTP 메서드
  • 요청 경로
  • 쿼리 파라미터
  • 일부 헤더
  • 호출 시간

예를 들어 Nginx 로그에서 API 경로를 찾을 수 있습니다.

grep "/api/" /var/log/nginx/access.log
Enter fullscreen mode Exit fullscreen mode

이 방법은 요청 본문이나 테스트 스크립트를 복구해 주지는 않지만, 컬렉션의 엔드포인트 구조를 다시 만드는 데 도움이 됩니다.

OpenAPI 또는 Swagger 사양 확인

API에 OpenAPI 사양이 있다면 컬렉션을 다시 구성할 수 있습니다.

확인할 파일:

  • swagger.json
  • openapi.json
  • openapi.yaml
  • swagger.yaml

이 파일을 Apidog 또는 다른 API 도구로 가져오면 문서화된 엔드포인트, 파라미터, 응답 스키마를 기반으로 프로젝트 구조를 재구성할 수 있습니다.

6. 복구한 컬렉션을 Apidog로 가져오기

컬렉션 JSON 파일을 확보했다면 Apidog로 가져오는 과정은 간단합니다.

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

환경 파일도 별도로 가져올 수 있습니다.

  1. Import를 클릭합니다.
  2. 소스 유형으로 Postman Environment를 선택합니다.
  3. 환경 JSON 파일을 업로드합니다.

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

7. 재발을 방지하는 백업 루틴 만들기

이번 상황의 핵심 문제는 컬렉션이 서버 측에 있고, 요금 정책 변경에 따라 접근이 제한될 수 있다는 점입니다. 어떤 도구를 사용하든 API 컬렉션은 정기적으로 내보내고, 팀이 소유한 저장소에 보관하는 습관이 필요합니다.

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

권장 백업 루틴

스프린트 종료 시마다 컬렉션을 JSON으로 내보내세요.

api-collections/
  postman/
    user-api.collection.json
    billing-api.collection.json
  environments/
    local.environment.json
    staging.environment.json
Enter fullscreen mode Exit fullscreen mode

컬렉션 파일은 Git 저장소에 커밋하세요.

git add api-collections/
git commit -m "Backup API collections"
Enter fullscreen mode Exit fullscreen mode

환경 파일을 저장할 때는 비밀 정보를 제거하세요.

{
  "name": "staging",
  "values": [
    {
      "key": "base_url",
      "value": "https://staging.example.com"
    },
    {
      "key": "api_key",
      "value": "REPLACE_ME"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

민감한 값은 다음 위치에 별도로 관리하세요.

  • 비밀번호 관리자
  • CI/CD Secret
  • Vault
  • 팀 보안 문서

이 루틴은 설정하는 데 오래 걸리지 않지만, 향후 접근 차단 상황에서 복구 시간을 크게 줄여 줍니다.

마무리

Postman 무료 티어 변경으로 팀 워크스페이스 접근이 막혔다면, 먼저 데스크톱 앱 캐시를 확인하고 가능한 모든 컬렉션을 즉시 내보내세요. 그다음 기존 백업 파일, Git 저장소, 워크스페이스 소유자, Postman API 키를 순서대로 점검하면 복구 가능성을 높일 수 있습니다.

컬렉션을 복구한 뒤에는 로컬 저장과 정기 백업이 가능한 워크플로로 전환하세요. API 컬렉션은 팀의 핵심 개발 자산이므로, 특정 요금제나 서버 측 접근 권한에만 의존하지 않는 구조로 관리하는 것이 안전합니다.

Top comments (0)