APIリクエストを行う際、開発・テスト・本番など複数の環境を切り替える必要があることが多い。Apidogでは、画面右上から簡単に環境を選択でき、異なる環境へのリクエスト送信がスムーズに行える。Apidogの環境は、2つのコア要素で構成されている。1つ目は「ベースURL(Base URL)」で、リクエストの送信先を管理する。2つ目は、リクエストやスクリプト内で参照できる1つ以上の「変数グループ」だ。環境を切り替えると、ベースURLと環境変数の両方が、選択中の環境で定義された値に自動的に切り替わる。環境の作成#
2
左側リストの一番下にある「新しい環境を作成する」をクリック。
3
新しい環境名を入力し、ベースURLや変数を追加する。
5
作成した環境を利用するには、画面右上の環境セレクターから選択する。これでその環境がアクティブとなり、全ての変数が環境で指定した値に設定される。
Apidogの環境は、Postmanの環境とは異なる。PostmanではベースURLごとに環境を分ける傾向があり、環境とベースURLの区別が曖昧になりがちだ。一方、Apidogの環境は、開発・テスト・本番といった実際の運用環境をそのまま反映している。ベースURLごとに環境を分けるのではなく、1つの環境内に複数のサービス(例:ユーザーサービス、注文サービスなど)をまとめて管理できる。ユーザー環境や注文環境のように、サービス 単位で環境を分割する必要はない。
ベースURLについて#
ベースURLは、Apidog環境の中核となる機能だ。Apidogでは、APIのパスはスラッシュ(/)から始まり、ベースURLは含まれない。APIリクエストを送信する際は、どのベースURLに送るかを明示的に指定する必要がある。そのため、環境ごとにベースURLを正しく設定することが重要となる。ベースURLの標準的な書式は、プロトコルから始まり、末尾にスラッシュ(/)を付けない形となる。