Postman コレクションのインポート

ビデオチュートリアル

PostmanとApidogの概念的な関係を理解することで、インポート時のデータの不整合を防ぐことができる。

PostmanのCollection は、Apidogのプロジェクト に相当する。したがって、Postman Collection内の変数は、Apidogプロジェクトのグローバル変数と同等だ。

Postman APIは前部URL（通常はドメイン名）を変数として保存するが、Apidogの前部URLは「環境管理」の「サービス」で独立して保存される。

この記事では、Apidog Echo APIを例として使用し、PostmanのデータをApidogにインポートする方法を説明する。

PostmanにApidog Echo というCollection があり、baseUrl と name という2つの変数が含まれているとする。

この Collection には GET リクエストがある。baseUrl は現在のリクエストの対象ドメイン名を指定するために使用され、name はクエリパラメータとして使用される。

Postmanの左サイドバーでCollectionsをクリックし、エクスポートしたいコレクションにマウスを合わせ、... アイコンをクリックして、エクスポートを選択する。

そして、Collection v2.1 形式を選択してエクスポートする。

Apidogで「設定」パネルを開き、「データのインポート」をクリックし、Postmanを選択してファイルをアップロードする。

インポートプレビューページで Collection 配下のすべてのAPIを確認できる。シームレスな移行のために、「環境」ページでCollectionと同じ名前の環境を確認し、「確認」ボタンをクリックする。

インポートプロセスが完了すると、APIドキュメントで name パラメータを、環境管理で baseUrl のリンクアドレスを確認できる。

APIにリクエストを送信する際は、対応する環境を選択する。パスの前に接頭辞URLが自動的に連結され、Postmanと一貫性が保たれる。