2026年3月1日に、Postman の新しいメジャーリリース、v12 がリリースされました。今回は、v12 で新たに導入されたネイティブ Git の背景と機能を深掘りし、皆さんの API 開発のワークフローが具体的にどう大きく変わるのか、実務に即したイメージをお届けしたいと思います。

API 開発における長年の悩みが、この v12 でついに解決されます。じっくりお付き合いください！

これまでの API 開発におけるサイロ化の課題

API 開発をチームで進める際、多くの開発者が一度は直面する壁があります。それは「情報と資産のサイロ化（分断）」です。

バックエンドのエンジニアは日々、GitHub や GitLab などのバージョン管理システム上でソースコードを管理し、ブランチを切り、プルリクエスト（PR）を出してレビューを行っています。これが現代のソフトウェア開発における「Single Source of Truth（信頼できる唯一の情報源）」です。

しかし、API 仕様やテストコレクションはどうだったでしょうか？

ソースコードは GitHub にある。
API のドキュメントやテストコレクションは Postman のクラウド（ワークスペース） にある。

この二重管理の状態により、以下のような課題が発生していました。

「コードは新しいエンドポイントに対応しているのに、Postman のコレクションが古いままだった・・」
「誰かが Postman 上のテストを直接書き換えてしまい、CI パイプラインがいきなり落ちた・・」
「API の変更履歴を Git のコミットログと突き合わせるのが非常に困難・・」

Postman のコレクションをエクスポートして Git リポジトリにコミットするという運用でカバーしていたチームもあるかと思いますが、手動エクスポートの手間や、「JSON形式のコレクションでコンフリクトが発生した時の解消の面倒臭さ」により、決してシームレスな体験とは言えませんでした。

v12 における新しい概念: ローカルビューとクラウドビュー

今回の v12 の目玉である「ネイティブ Git」を理解する上で、押さえておきたい新しい概念があります。それが「クラウドビュー（Cloud View）」と「ローカルビュー（Local View）」です。

従来の Postman は、基本的にすべてのデータが Postman のサーバー（クラウド）と同期される仕組みでした。しかし v12 では、このアーキテクチャが大きく見直されました。

クラウドビュー: 従来通り、Postman クラウドに保存・同期されるワークスペースの表示です。チーム全体で完成した API フローを共有したり、実行したりするためのデフォルトのビューとなります。
ローカルビュー: 皆さんのマシン上のローカル Git リポジトリ（ファイルシステム）と直接連動する新しいビューです。API コレクションや環境変数はプロジェクト内の postman フォルダに物理ファイルとして保存され、ここが API の変更を行う「編集可能なワークスペース」となります。

次の画像は、ローカルビューに切り替えて、新しいファイルビュワーツールでコレクション内のリクエストを表示したところです。

Postman の1つのワークスペース上のデータは、ローカルとクラウドで別々に状態が管理されることになり、必要なタイミングで同期が行われます。ローカルファイルシステムに置かれるデータは Git 管理下にあるため、Postman のコレクションや環境変数をバックエンドのコードと同じリポジトリで管理ができるようになります。

AIエージェントとの親和性

そして、このローカルファイルシステムに物理ファイルとして保存されることには、もう一つ大きなメリットがあります。それは AI エージェントが効率的に API データにアクセスして作業しやすくなるという点です。

postman フォルダー内に API の仕様やテストがテキストベース（後述の YAML）で置かれているため、ローカルで動く AI コーディングエージェントがプロジェクト全体のコンテキストを瞬時に読み取り、「この API エンドポイントの仕様に合わせてバックエンドの実装を生成して」といった指示に、高い精度で応えられるようになります。

JSON から YAML へ: Git Diff のつらみからの解放

これまで「Postman コレクションを Git 管理する」というアプローチに挑戦し、挫折した開発者の多くは、JSON ファイルの差分管理やコンフリクト（競合）の問題に直面したはずです。

従来の巨大な JSON 形式のコレクションファイルは機械には読みやすいですが、人間が Git の差分（Diff）を読んでレビューするには全く適していませんでした。ID の変更や、エクスポートごとのキーの順序の入れ替わりなどで、実質的な変更がなくても数千行の Diff が出てしまうことがありました。

待望の「V3 フォーマット（YAML）」の登場

Postman v12 では、この問題を根本から解決するために、コレクションの保存形式に YAML ベースの Postman Collection V3 フォーマット、さらにマルチファイル構成を新しく採用しました。

特徴	従来の JSON フォーマット (V2.1)	新しい YAML フォーマット (V3)
ファイル構成	巨大な1つの JSON ファイル	フォルダ・リクエストごとの複数 YAML ファイル
Git Diff の可読性	悪い（メタデータがノイズになる）	非常に良い（純粋な変更点のみハイライト）
コンフリクト解消	手動マージは非常に困難	エディタ標準のマージツールで簡単に解消可能

YAML フォーマットになり、リクエストごとにファイルが分割されたことで、Git 上での差分が驚くほどスッキリします。GitHub のプルリクエスト画面で、GET /users のテストスクリプトに1行追加されたことがソースコードの変更と並んでクリアに表示され、レビュアーの負担は激減します。

実際の開発フロー

さて、いよいよローカルビューを使った実践的なワークフローのお話です。

実は、Postman v12 のデスクトップアプリ自体が、強力な「IDE（統合開発環境）風の UI」へと劇的な進化を遂げています。そのため、外部のツールを行ったり来たりすることなく、API 開発のすべてを Postman の中で完結させることができます。

実際の開発フローを見てみましょう。

ステップ1: ワークスペースを Git 管理下のフォルダーに接続

まずは Postman ワークスペースを、バックエンドサービスの Git リポジトリと関連付けます。具体的には、GitHub 等でホストされている remove origin を持っている、Git 管理下のローカルフォルダーに接続します。

ステップ2: Postman の内蔵ターミナルでローカルサーバーを起動

Postman v12 にはターミナルが内蔵されました。

画面下部のフッターにあるボタンからターミナルを立ち上げ、例えば Laravel なら php artisan serve、Node.js なら npm run dev と叩くだけで、Postman の画面から一歩も出ずに開発用ローカルサーバーを起動できます。

ステップ3: ローカルビューでリクエストを修正し、Agent Mode でテスト生成

バックエンドのソースコードを編集し、例えば API に新しいパラメーターを追加したとします。

次に、Postman の表示を「ローカルビュー（Local View）」に切り替えます。ここで、先ほどのソースコードの変更に合わせて、Postman 上のリクエスト（URL パラメーターやボディなど）を修正します。

そして、新しくなった Postman の AI 機能である Agent Mode を呼び出します。「追加したパラメーターが正しくレスポンスに含まれているか検証するテストを書いて」と指示するだけで、Agent Mode がサクッとテストスクリプトを生成・追加してくれます。

ステップ4: 内蔵ターミナルから Git コミット＆プッシュ

API が期待通りに動き、テストも通ったら、いよいよ Git への保存です。

ここでも別のターミナルアプリを開く必要はありません。Postman の内蔵ターミナルから直接コマンドを叩きます。

git add .
git commit -m "feat: 新規パラメーターの追加とテストの更新"
git push origin feature/new-parameter

これにより、バックエンドの実装コードと、postman フォルダー内の API コレクション（YAML）が、同じコミットとしてリモートリポジトリにプッシュされます。

ステップ5: PR レビューと、デプロイ時の「完全自動同期」

プッシュした後は、GitHub などのプラットフォーム上でプルリクエスト（PR）を作成し、チームメンバーにレビューしてもらいます。YAML 化されているため、レビュアーは API の変更点を Git の差分として簡単に確認できます。

そして、ここからが重要です。PR がマージされ、実際にサーバーへデプロイされるタイミングで、GitHub Actions 等の CI/CD パイプラインを走らせます。

このパイプラインの中で、以下の2つを自動実行するように構成します。

自動 API テストの実行: Postman CLI を使って、デプロイされた環境に対して最新のテストコレクションを実行し、品質を保証します。
Postman クラウドへの自動同期: テストがパスしたら、Postman CLI 経由でローカルの変更（postman フォルダーの内容）をPostman クラウド（クラウドビュー）に自動的に同期します。

この徹底した自動化フローを組むことで、「コードは更新されたのに、Postman 上のコレクションが古くて他の人が困る」という、いわゆる「API ドリフト（API の実装とドキュメントの乖離）」が根絶されます。

API カタログによる組織全体のガバナンス強化

個人の開発体験が向上するだけでなく、組織規模でのメリットもあります。Postman v12 では組織全体での API の可視性とガバナンスを提供する「API カタログ（API Catalog）」機能が追加されています。

リポジトリ内に分散している API 仕様（OpenAPI など）やコレクションは、Postman クラウドと同期され、組織内のプライベートな「API カタログ」に自動的にインデックスされます。

開発パイプラインの状態の可視化: 組織内の API プロジェクトのテスト実施状況や、デプロイの状態が一目で把握できるようになります。
重複開発の防止: カタログを検索すればすぐに社内の既存 API を発見でき、「似たような API を別のチームが作ってしまう」無駄を防ぎます。
オーナーシップの明確化: どの API が、どのチームのリポジトリで管理されているかが一目瞭然になります。
セキュリティとガバナンス: 組織の標準ガイドラインに API が準拠しているかをダッシュボードで監視できます。

組織の規模が大きくなればなるほど、この「API の可視化」は計り知れない価値を生み出します。

おわりに: API 開発の新しいスタンダード

Postman v12 の Git ネイティブ連携により、API の開発・テストは通常のソフトウェア開発のワークフローに完全に統合されました。

「API は単なるツールで叩くもの」から、「コードと共にバージョン管理され、進化していく資産（API as Code）」へのパラダイムシフトです。

まだこの新しい Git 統合や YAML フォーマット、そして IDE 風に進化した新しい Postman の UI を試していない方は、ぜひ明日からご自身のプロジェクトを Postman v12 で開いてみてください。このフローに馴染んでしまうと、もう元の開発スタイルには戻れなくなるはずです！