まとめ
Postmanの無料プランは、多くの開発者が予期せぬ形でコレクション共有を制限しています。月額19ドル/ユーザーを支払わずにチームメイトと共同作業を行う必要がある場合、いくつかの回避策がありますが、それぞれに実際のトレードオフが伴います。Apidogの無料プランでは、アップグレードなしで最大3人のユーザーとワークスペースを共有できます。
はじめに
Postmanは、HTTPリクエストを送信するためのシンプルなChrome拡張機能として始まりました。長年にわたり、本格的なAPIプラットフォームへと成長し、それに伴い価格設定も高くなりました。現在、コレクションを共有し、リアルタイムで共同作業を行いたいチームは、有料プランが必要です。無料プランでは、多くの開発者が回避策を模索しています。
小さなチーム、サイドプロジェクト、または一ドルが重要となるスタートアップを運営している場合、コレクションを共有するためだけに月額19ドル/ユーザーを支払うのは高く感じられます。これは、単一の機能をリリースする前に年間一人あたり228ドルにもなります。
幸いなことに、Postmanの無料プランでコレクションを共有する正当な方法がいくつか存在します。それらのどれもチームプランを支払うほどスムーズではありませんが、機能はします。このガイドでは、それぞれの方法を説明し、何が問題になるのか、そして真に無料の代替手段がどのようなものかを示します。
Postmanの無料プランで実際にできること
回避策を検討する前に、2024年から2025年における無料プランの内容を理解することが役立ちます。
Postmanの無料プランでは、以下の機能が提供されます。
- ワークスペースあたり1ユーザー（共同編集なし）
- 最大3つのアクティブな公開ワークスペース
- 無制限の個人ワークスペース
- 月間1,000回のモックサーバー呼び出し
- 月間1,000回のモニタリング呼び出し
- クラウドランナーでのコレクション実行は月間25回までに制限
決定的な制限は、無料プランではプライベートワークスペースにチームメイトを招待できないことです。プライベートワークスペースには、月額19ドル/ユーザーのベーシックプラン以上が必要です。これが、ほとんどの小規模チームが最初に直面する壁です。
方法1：コレクションをJSONとしてエクスポートし、ファイルを共有する
最も直接的な回避策は、コレクションをJSONファイルとしてエクスポートし、チームメイトに送信することです。
手順：
- Postmanを開き、左サイドバーでコレクションに移動します。
- コレクション名の隣にある三点リーダーメニューをクリックします。
- 「エクスポート」を選択します。
- コレクションv2.1形式を選択します（これが現在の標準であり、最も広い互換性があります）。
- JSONファイルを保存し、メール、Slack、または共有ドライブ経由で共有します。
チームメイトは、ファイル > インポートに移動し、JSONファイルをドラッグすることでインポートできます。
問題点：
- エクスポートした瞬間、コレクションはスナップショットになります。新しいエンドポイントを追加したり、リクエストを修正したりしても、チームメイトはそれを知る方法がありません。彼らは古いコピーで作業することになります。
- 環境変数はデフォルトではコレクションと一緒に移動しません。環境を個別にエクスポートする必要があり、チームメイトもそれをインポートする必要があります。一つの変数を忘れると、彼らのリクエストは失敗し、実際には壊れていないもののデバッグに時間を費やすことになります。
- マージワークフローはありません。2人がローカルコピーを同時に編集し、それを調整しようとすると、手作業で行うことになります。
この方法は、時折の一回限りの引き渡しには機能します。コレクションが頻繁に変更される場合は、すぐに破綻します。
方法2：公開ワークスペースを使用する
Postmanでは、無料プランで公開ワークスペースを作成できます。リンクを知っている人なら誰でもコレクションを閲覧し、フォークできます。
設定方法：
- Postmanで新しいワークスペースを作成します。
- 可視性を選択するよう求められたら、「公開」を選択します。
- コレクションを公開ワークスペースに追加します。
- ワークスペースのURLをチームメイトと共有します。
チームメイトは、コレクションを自分のワークスペースにフォークし、そこから作業できます。
問題点：
- 公開とは、文字通り公開されているという意味です。URLを知っているか、Postmanの公開APIネットワークを検索すれば、インターネット上の誰でもあなたのコレクションを見つけることができます。社内ツール、ステージング環境、または例示応答に認証トークンが埋め込まれているものについては、これは重大なリスクとなります。
- フォークされたコレクションは自動的に同期されません。オリジナルを更新した場合、チームメイトは手動で変更を自分のフォークにプルする必要があります。変更があったという通知はありません。
- コメント機能や直接的な共同作業には、依然としてチームプランが必要です。公開ワークスペースは閲覧者にとって読み取り専用であり、オリジナルを編集することはできません。
この方法は、オープンソースプロジェクトや公開APIドキュメントには適しています。社内チームのワークフローには向きません。
方法3：Gitリポジトリを同期レイヤーとして使用する
一部のチームは、エクスポートされたJSONをコードアーティファクトとして扱い、Gitリポジトリにコミットすることで同期問題を解決しています。
ワークフローは次のとおりです：
- 一人がPostmanコレクションを所有し、意味のある変更があるたびにエクスポートします。
- 更新されたJSONを共有Gitリポジトリ（GitHub、GitLab、Bitbucket）にコミットします。
- チームメイトは最新バージョンをプルし、それを自分のローカルのPostmanにインポートします。
問題点：
- インポートするたびに、既存のローカルコレクションが上書きされます。もしチームメイトがローカルで変更を加えていた場合、事前にエクスポートしてマージしない限り、その変更は失われます。
- このワークフローには規律が必要です。何か変更があるたびに、誰かがエクスポートしてコミットすることを覚えていなければなりません。実際には、Gitのバージョンは実際のPostmanの状態にほとんど常に遅れをとります。
- Gitリポジトリから直接リクエストを実行することはできません。常に誰かがインポート手順を行う必要があり、これは時間がかかり、摩擦を生みます。
この方法は、履歴と単一の信頼できる情報源を提供するため、生のファイル共有よりも優れていますが、手作業のステップがオーバーヘッドとなり、チームの速度を低下させます。
方法4：Postmanの無料個人ワークスペースを「プライマリ」アカウント1つで使用する
一部の小規模チームは、全員で1つのPostmanアカウントを共有することで、共同作業の制限を回避しています。一人が同じ認証情報を使って複数のマシンにログインします。
これはPostmanの利用規約に違反しており、実際の問題を引き起こします：
- Postmanは共有された認証情報を検出し、アカウントをロックする可能性があります。
- 同期の競合が発生した場合、ある人が行った変更が他の人が行った変更を上書きする可能性があります。
- 特定の人物に変更を帰属させる方法がありません。
この方法は、チームが実際に使用しているためここに記載していますが、それが良いアイデアだからではありません。
Apidogが無料プランでの共有をどのように扱うか
Apidogは共同作業の問題に対し、異なるアプローチを取っています。無料プランには、共有ワークスペースで最大3人のチームメンバーが含まれ、全員でリアルタイム同期が可能です。回避策やJSONファイルの手動でのやり取りは不要です。
ApidogでAPI定義に変更を加えると、チームメイトはそれをすぐに確認できます。誰もエクスポートやインポートを行うことなく、全員が同じ信頼できる情報源から作業できます。
すでにPostmanを使用している場合でも、既存のコレクションを直接インポートできます。ApidogはPostman Collection v2.1形式を読み取れるため、切り替えはワンクリックで完了し、週末プロジェクトになるような手間はありません。
無料プランには、以下の機能も含まれています。
- フル機能のAPIデザインエディタ（OpenAPI 3.0およびSwagger）
- クラウドに依存せずリアルなレスポンスを生成するスマートモック
- 月間実行制限なしのテストランナー
- 定義から自動生成されるAPIドキュメント
- ローカルファーストストレージ（同期を選択しない限りデータはマシンに保存されます）
2～3人のチームにとって、Apidogの無料プランは、Postmanのチームプランと同等の機能を無料で提供します。
状況に応じた適切な方法の選択
迅速な意思決定ガイドを以下に示します。
| 状況 | 最適なアプローチ |
|---|---|
| 一度限りの引き渡し、コレクションは安定している | JSONをエクスポートしてファイルを共有する |
| オープンソースプロジェクト、機密データなし | Postman公開ワークスペース |
| 開発者チーム、活発な開発 | Apidog無料プラン |
| すでにGitを使用しており、バージョン履歴が必要 | Git + JSONエクスポートワークフロー |
チームが積極的にAPIを構築しており、Postmanの共有制限に直面している場合、JSONやGitの回避策は作業を遅らせるでしょう。これらは目先の問題を解決しますが、継続的な摩擦を生み出します。
よくある質問
Postmanコレクションをアカウントなしで共有できますか？はい、できます。コレクションをJSONファイルとしてエクスポートし、ファイルを直接送信してください。受信者は、Postman Collection v2.1形式をサポートするAPIクライアント（Apidogを含む）を使用している場合、Postmanアカウントなしでインポートできます。
Postmanのベーシックプランではチーム共有が可能ですか？はい。月額19ドル/ユーザーのベーシックプランでは、複数ユーザーとのプライベートワークスペースでの共同作業が可能です。無料プランではできません。
Postmanの公開ワークスペースとは何ですか？公開ワークスペースは、インターネット上の誰でも閲覧できるものです。訪問者はコレクションを閲覧したりフォークしたりできますが、オリジナルを編集することはできません。無料プランでは最大3つの公開ワークスペースを無料で作成できます。
環境変数はコレクションと一緒にエクスポートされますか？いいえ。環境変数は個別にエクスポートされます。サイドバーの「環境」に移動し、必要な環境の三点リーダーメニューをクリックして、別のJSONファイルとしてエクスポートしてください。両方のファイルをチームメイトと共有してください。
Apidogの無料プランでは、何人のユーザーがワークスペースを共有できますか？Apidogの無料プランは、クレジットカード不要で、リアルタイム同期を備えた共有ワークスペースで最大3人のユーザーをサポートします。
既存のPostmanコレクションをApidogにインポートできますか？はい、できます。ApidogはPostman Collection v2.1 JSONファイルの直接インポートをサポートしています。Apidogで「インポート」に移動し、ファイルを選択すると、リクエスト、ヘッダー、環境変数がそのままコレクションとして取り込まれます。
Postmanの無料プランにおける共有制限は現実のものであり、回避策には時間と信頼性において実際のコストがかかります。最大3人までのチームで本格的な共同作業が必要な場合、絶え間ない手動作業を必要とするワークフローを繕うよりも、無料プランでの共有のために構築されたツールに切り替える方が、多くの場合、よりスマートな解決策です。