ロックアウトされたPostmanコレクションを復元する方法

要するに（TL;DR）

Postmanの無料プラン変更によって共有コレクションへのアクセスが遮断されたとしても、データが完全に失われたわけではありません。ただし、ローカルキャッシュがクリアされる前に迅速に行動する必要があります。このガイドでは、ローカルアプリキャッシュからエクスポートファイル、チーム管理者による復旧、そして復旧したデータをApidogに移行して再び同じ状況に陥らないようにする方法まで、利用可能なあらゆる復旧経路を説明します。

はじめに

不満はすぐに噴出しました。Postmanの2026年第1四半期の無料ティア更新後、同僚とワークスペースを共有していた開発者たちは締め出されてしまいました。共有ワークスペースはアクセス不能になり、個人ワークスペースではなくチームワークスペースにあったコレクションは突然有料化の対象となりました。

ある開発者はRedditでこう述べています。「月曜日に出勤したら、チームワークスペース全体がなくなっていたんです。3ヶ月かけて整理したコレクションも、環境も、すべてです。支払わない限り、もう何もありません。」

苛立たしいのは、データが実際に削除されたわけではないという点です。Postmanのアーキテクチャではワークスペースデータはサーバーサイドに保存されており、ロックアウトはアクセス制限であり、削除ではありません。しかし、その区別が重要になるのは、キャッシュが期限切れになるかワークスペースがクリーンアップされる前に、その状況をどうにかする方法を知っている場合だけです。

まずはPostmanデスクトップアプリのキャッシュを確認してください

他のことをする前に、Postmanデスクトップアプリがインストールされている場合は、それを開いてください。ウェブ版は開かないでください。

デスクトップアプリは、最近アクセスしたコレクションと環境のローカルキャッシュを保存しています。サーバーサイドへのアクセスが取り消されたとしても、キャッシュには短期間（システムやPostmanのキャッシュ無効化の管理方法にもよりますが、通常数日から1週間程度）コレクションデータが残っている可能性があります。

確認手順：

1. Postmanデスクトップアプリを開きます（app.getpostman.comのウェブアプリではありません）。
2. 履歴タブで最近のリクエストを確認します。これらには完全なコレクション構造は含まれませんが、どのようなエンドポイントで作業していたかを確認できます。
3. コレクションが左サイドバーにまだ表示されているか確認します。表示されている場合は、すぐにエクスポートしてください。

サイドバーからエクスポートするには、コレクションを右クリックするか、三点メニューをクリックし、「エクスポート」を選択して、Collection v2.1として保存します。表示されているすべてのコレクションに対してこれを行ってください。

コレクションが表示されるのに、エクスポートしようとするとエラーが発生する場合は、オフラインで作業してみてください。Postmanで、右上にあるアバターをクリックし、「オフラインにする」を選択します。アプリはサーバーとの同期を試みなくなり、キャッシュされたデータへの読み取りアクセスを十分に長く提供し、エクスポートできる場合があります。

既存のエクスポートファイルを探す

多くの開発者は、バックアップや同僚との共有のために、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`パイプライン設定ファイルを確認してください。

ワークスペースの所有者または管理者に連絡する

あなたが誰かのチームワークスペースのメンバーだった場合、そのワークスペースの所有者がアカウントの唯一のユーザーであるか、有料プランにアップグレードしている場合は、まだ完全なアクセス権を持っている可能性があります。

ワークスペースの所有者に直接連絡し、以下のことを依頼してください。

1. Postmanアカウントにログインする。
2. 共有していたワークスペースに移動する。
3. 三点メニューから各コレクションをエクスポートする。
4. エクスポートされた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キーがまだアクティブである限り機能します。APIキーのアクセスは、UIアクセスが取り消された後も短期間存続する場合がありますが、長期間続くとは限りません。これらのリクエストはできるだけ早く実行してください。

APIキーを保存していない場合は、プロジェクトの`.env`ファイル、CI/CD環境変数設定、またはパスワードマネージャーを確認してください。

ブラウザのネットワークログまたはサーバーログから再構築する

上記のどのオプションも機能せず、本当にエクスポートもキャッシュもない場合、他のソースからコレクションを部分的に再構築できる可能性があります。

ブラウザのネットワークログ。 最近Postmanウェブアプリを使用していた場合、ブラウザが応答をキャッシュしている可能性があります。Chromeで、DevTools (F12) を開き、次にApplication > Cache Storageに進みます。キャッシュされたPostman APIの応答を探してください。これには完全な構造化されたコレクションが含まれる可能性は低いですが、リクエストの詳細が含まれている場合があります。

サーバーアクセスログ。 チームがPostmanでテストしていたAPIを実行していた場合、サーバーのアクセスログには、呼び出されたすべてのエンドポイントが、メソッド、パス、場合によってはヘッダーとともに表示されます。これにより、リクエストボディやテストスクリプトは得られませんが、コレクションを整理するためのエンドポイント構造が得られます。

OpenAPI/Swagger仕様。 APIにOpenAPI仕様（`swagger.json`または`openapi.yaml`ファイル）がある場合、それをApidogまたは別のツールに直接インポートして、文書化されたエンドポイント、パラメーター、応答スキーマを持つコレクション構造を再作成できます。

復元したコレクションをApidogにインポートする

コレクションのJSONファイルがあれば、Apidogへのインポートは約2分で完了します。

1. Apidogデスクトップアプリをダウンロードしてインストールするか、ウェブ版を開きます。
2. 新しいプロジェクトを作成します。
3. プロジェクト内で、左サイドバーの「インポート」をクリックします。
4. インポート元として「Postman」を選択します。
5. コレクションのJSONファイルをアップロードします。
6. 各コレクションに対して繰り返します。

環境については、同じインポートフローを使用して、「Postman Environment」をソースタイプとして選択し、個別にインポートします。

インポート後、チームメイトを招待します。Apidogの無料プランでは、最大3ユーザーがワークスペースを共有できます。コレクションはすべてのチームメンバー間で同期され、席ごとの料金はかかりません。

再びこの状況に陥らないために

根本的な問題は、Postmanがコレクションをサーバーサイドに保存し、課金によってアクセスを制限したことにあります。データをローカルに保持するか、明確なエクスポート所有権を提供するツールを選択することで、この問題を完全に回避できます。

Apidogはデフォルトでコレクションをローカルに保存します。クラウド同期はオプションであり、必須ではありません。万が一価格変更があっても、データはすでにあなたのマシン上にあります。

今後どのツールを使用するかにかかわらず、定期的なエクスポート習慣を構築してください。

• 各スプリントの終わりにコレクションをJSONとしてエクスポートする。
• コレクションのJSONファイルをコードベースと一緒にGitリポジトリにコミットする。
• 環境ファイル（機密情報が削除されたもの）をリポジトリの開発ドキュメントに保存する。

これらの習慣は、設定に5分かかり、「ロックアウトされた」シナリオを完全に排除します。

頼りにしているツールへのアクセスを警告なしに失うことは、非常に不満を感じる経験であり、Postmanの無料ティア変更は多くのチームを不意打ちで襲いました。幸いなことに、迅速に行動し、利用可能なオプションを順に試せば、ほとんどのデータは回復可能です。コレクションをエクスポートして立ち直った後は、データをローカルに保持するツールに移行することで、長期的にははるかに良い状態を保つことができます。