API呼び出しを行う際、開発環境、テスト環境、本番環境を切り替える必要がよくあります。Apidogでは、インターフェース右上で環境を選択するだけで、異なる環境へのリクエスト送信が簡単に行えます。Apidogの環境は2つの主要要素で構成されています。1つ目は「サービス（ベースURL）」で、リクエストの送信先を管理するために使用されます。2つ目は、リクエストやスクリプトで参照できる1つまたは複数の「変数」のグループです。環境を切り替えると、サービス（ベースURL）と環境変数の両方が、現在の環境で定義された値を使用します。環境の作成#
1
インターフェース右上の「環境管理」ボタン「≡」をクリックします。
2
左側リストの最後の項目「新しい環境を作成する」をクリックします。
3
新しい環境の名前を入力し、サービスのベースURLと変数を追加します。
5
新しい環境を使用するには、インターフェース右上の環境セレクタから選択します。これにより環境がアクティブになり、すべての変数が環境で指定された値に設定されます。
ApidogとPostmanでは環境の考え方が異なります。Postmanでは各ベースURLを別々の環境として扱う傾向がありますが、これは環境とベースURLの区別を曖昧にしています。一方、Apidogの環境は、開発、テスト、本番といった実際の環境を直接反映し、各ベースURLを単一の環境として扱うことはありません。例えば、テスト環境内には、ユーザーサービスや注文サービスなど、様々なサービスが同じテスト環境内に含まれることがあります。これらのサービスを別々のユーザー環境や注文環境に分けるべきではありません。
サービス（ベースURL）#
サービス（ベースURL）は、Apidog環境の主要機能です。Apidogでは、APIはスラッシュ（/）で始まり、ベースURLは含まれません。APIリクエストを送信する際は、送信先のベースURLを指定する必要があります。これは環境内のサービス機能の重要性を示しており、APIリクエストの送信には特定の環境の選択が前提となります。標準的なベースURLの形式は、プロトコルで始まり、末尾のスラッシュ（/）は含まない形式です：各環境には「デフォルトサーバー」があります。APIが特定のサービスを指定していない場合、リクエストはデフォルトサーバーに転送されます。例えば、本番環境の「デフォルトサーバー」のベースURLが「http://abc.com/v1」で、APIのパスが「/pet」の場合、本番環境でリクエストを送信すると、実際のリクエストは以下のようになります：APIのパスが http:// または https:// で始まる場合、ベースURLは追加されません。ただし、この方法は一般的に推奨されません。
Apidogには、現在の環境の「デフォルトサーバー」のベースURLを保存するBASE_URLという特別な環境変数があります。この変数の使用は一般的に推奨されません。カスタムスクリプトでは、現在のAPIのベースURLを取得するために「pm.request.getBaseUrl()」を使用することをお勧めします。「pm.environment.get('BASE_URL')」の使用は避けてください。APIが「デフォルトサーバー」を使用し ていない場合、現在のAPIのベースURLを正しく取得できない可能性があります。ユーザーが手動でBASE_URLという環境変数を作成した場合、システムの定義済みBASE_URLより優先されます。スクリプトでベースURLを変更することはできません。スクリプト内の「pm.environment.set('BASE_URL', 'My_url')」は、ベースURL自体を変更するのではなく、BASE_URLという実際の環境変数を作成します。
複数サービスの利用#
プロジェクトで複数の異なるサービスを使用する場合（例：ユーザー関連のリクエストをhttps://user.abc.com へ、注文関連のリクエストをhttps://order.abc.com へ送信する場合）、複数のサービスを利用する必要があります。具体的な手順は以下の通りです：1
1．環境に複数のサービスとそれぞれのベースURLを追加します。
2
APIを指定のサービスに割り当てます。
設計モードでは、「編集タブ」のServiceドロップダウンからサービスを選択します。
デバッグモードでは、「情報タブ」のServiceドロップダウンからサービスを選択します。3
フォルダ単位でもサービスを追加できます。フォルダ名をクリックし、フォルダ設定でServiceドロップダウンからサービスを選択します。そのフォルダ内のすべてのAPIがこのサービスに転送されます。
4
インターフェース右上で環境を選択して送信すると、サービスに紐付けられたAPIは対応するベースURLに転送されます。
5
環境管理で異なる環境に切り替えると、ユーザーサービスと注文サービスが他の環境にも追加されているが、ベースURLが空になっていることに気付くかもしれません。
これは、ほとんどのチームでテスト環境と開発環境に対応するサービスがあるためです。各環境のそれぞれのベースURLを設定することで、右上で環境を切り替えると、すべてのAPIリクエストが正しいサービスに転送されます。実際には、これが最も効率的な設計アプローチです。環境変数の追加#
環境に変数を追加する際、その変数の初期値（共有）と現在値（ローカル）を指定できます。環境の切り替え#
Apidogはワークベンチの右上にある環境セレクタで現在の環境を表示します。リクエストの送信やスクリプトの実行時、Apidogは選択された環境のすべての変数の現在値を使用します。異なる環境に切り替えるには、環境セレクタから選択するだけです。Apidogでは、APIとリクエストは異なる概念です。APIはAPI仕様を表し、ベースURLは含まれません。一方、リクエストは具体的なAPIリクエストで、ベースURLを含みます。そのため、Apidog環境で定義されたサービスは、APIにのみ適用され、リクエストには適用されません。リクエスト機能を使用する場合、Postmanと同様に{{Base_url}}構文を使用して環境変数を利用できます。
環境の移行#
Apidogでは、変数の初期値はチーム内で同期されますが、現在値はローカルにのみ保存されます。つまり、別のコンピュータでApidogを使用する場合、以前使用した現在値にアクセスできません。そのため、Apidogは環境の移行機能を提供しています。環境内のサービスと変数をJSONファイルとしてエクスポートし、別のコンピュータにインポートできます。手順は以下の通りです：1
環境管理で、環境リスト横の「
...」にカーソルを合わせ、エクスポートをクリックしてJSONファイルを取得します。
2
別のコンピュータで環境管理を開き、環境リスト横の「...」にカーソルを合わせ、インポートをクリックします。JSONファイルを選択してインポートします。
3
Postmanからエクスポートした環境もインポートできます。
環境の可視性スコープ#
個人使用のみの変数を作成し、他のユーザーから見えないようにしたい場合があります。そのような場合は、「プライベート環境」を作成できます。環境の右上で、環境の可視性スコープを設定できます。デフォルトでは共有されていますが、作成した環境を自分にのみ表示されるように設定できます。ただし、他のユーザーが作成した環境の可視性は変更できません。プライベート環境は他の環境と同じサービスリストを共有します。プライベート環境でのサービスの追加や削除は、すべての環境に同時に影響します。
