Swaggerは、API仕様書を自動生成するためによく利用されるオープンソースフレームワークです。Swaggerフレームワークで記述しているAPIをPostmanにインポートして、テストの効率化を図るのはごく一般的なことになります。本文では、SwaggerのAPI（Swagger Specファイル）をPostmanに完全にインポートする方法を紹介した上、Postmanより使いやすいAPIクライアントをも皆さんにお勧めします。
Swagger仕様のAPIとPostman
SwaggerはAPI設計書を自動生成するためのオープンソースフレームワークで、Swagger Spec(OpenAPI Specification)は、Swaggerが使用するAPI記述言語の仕様です。Swagger仕様は、YAMLやJSON形式でAPIの構造を定義するための標準的な方法を提供します。現在、Swagger仕様に準拠した形式で記述されたAPIはすでに主流になっています。
SwaggerはAPIのドキュメント化に強みがある一方、PostmanはAPIのテストと検証に強みがあります。両者を組み合わせることで、ドキュメント作成とテストを効率的に行えます。そこで、APIのテストと検証の効率化を図るために、Swagger仕様のAPIをPostmanにインポートすることが多く見られています。
SwaggerのAPIをPostmanにインポートする方法
SwaggerのAPIをPostmanにインポートするために、通常2つの方法によって実現できます。SwaggerドキュメントのURLからインポートすることもできますし、Swagger Specファイルからインポートすることもできます。次は、この2つの方法を1つずつ紹介します。
URL経由でSwaggerのAPIをPostmanにインポート
ステップ⒈SwaggerのAPIのページを開きます。通常API名の下にドキュメントのURLが記載されています。そのURLをコピーします。
ステップ⒉Postmanを開き、画面の左上にある「Import」ボタンをクリックします。
ステップ⒊Postmanの入力ボックスに先にコピーしたURLを貼り付けると、インポートのプロセスが開始されます。
ステップ⒋インポート方式を選択して、「Import」ボタンをクリックすると、SwaggerのAPIをPostmanにインポートできます。
ステップ⒌インポートプロセスが完了すると、Postmanの左側のメニューからインポートできたAPIを確認できるようになります。
Swagger Specファイル経由でAPIをPostmanにインポート
SwaggerドキュメントのURLを使って、APIを簡単にPostmanにインポートできますが、Swagger Specファイル（JSONかYAMLフォーマット）を使っても、APIをPostmanにインポートすることもできます。
ステップ⒈SwaggerドキュメントのURLを開くと、JSONデータを取得することができます。
ステップ⒉パソコンで空のJSONファイルを作成して、ページ上のJSONデータを丸ごとファイルにコピーします。
ステップ⒊Postmanを開き、「Import」ボタンをクリックし、インポートエリアにJSONファイルをドラッグ＆ドロップすることで、APIをPostmanにインポートできます。
Apidog：より使いやすくSwagger互換のAPIクライアント
ApidogはOpenAPI（Swagger）の仕様を完璧にサポートしています。そこで、 Swagger仕様のAPIをインポートして、より効率的にテストしたり、より綺麗なAPIドキュメントを生成したりすることを実現したい場合は、それを直接にApidogにインポートして、シームレスに作業を進むことができるのでしょう。
また、ApidogはSwaggerからの自動インポートにも対応できます。つまり、Swagger側でAPI仕様に何か変更がある場合でも、それが自動的にApidogで反映されます。
ApidogはPostmanより便利にAPIをテスト可能
Postmanには実行制限や環境切り替えの問題などの課題がある一方、Apidogは日本語にも対応可能な新世代のAPI管理ツールだと捉えています。Apidogは、APIの設計、仕様書生成と共有、APIモック、APIテストなどの機能も完備しています。また、ApidogはAPI定義との連携、視覚的なテスト作成、環境とサービスの分離など、Postmanの欠点を多数改善しています。
詳しくは：Apidogとpostmanの違い｜どちらにしようかを完全解説
APIの開発効率を向上させたい場合でも、APIの品質を上げたい場合でも、Apidogを利用するのがおすすめです。
まとめ
本記事では、Swaggerで記述したAPI定義をPostmanにインポートする方法を紹介しました。SwaggerのドキュメントURLやSpecファイルからPostmanにインポートできます。PostmanではインポートしたAPIを基にテストを作成できます。
一方、ApidogはSwagger APIのインポートにも対応しつつ、APIの設計やテストも行える新世代のツールです。ApidogはPostmanの欠点も改善しており、APIの開発効率を高めたい場合におすすめです。
