バックエンドのサーバー変数の追加
バックエンドを作成または編集するときに、「サーバー」タブのインスタンスURLにサーバー変数を追加できます。
インスタンスURLに{version}などの有効なURIテンプレート式を入力すると、サーバー変数が自動的に作成され、サーバー・エディタの「サーバー変数」セクションに表示されます。 変数リストを作成、編集または順序変更することもできます。 サーバー変数ごとにデフォルト値を設定する必要があります。
https://restcountries.com/v3.1/lang/germanを例として使用して、これがどのように機能するかを見てみましょう:
- サーバー・インスタンスURLは、
https://restcountries.com/{version}/langとして表すことができます。ここでは、countryBackendというバックエンドのサーバーに示すように、デフォルト値がv3.1のサーバー変数
{version}が1つのみ存在します:
図backend-edit-server.pngの説明 - エンドポイントは
/{language}です。エンドポイントを定義し、URLパスに
/{language}を追加することで、countryBackendでサービス接続を定義します。
この例では、languageはエンドポイント・パスの一部であるため、パス・パラメータです。 この例はインスタンスURLの外部にあるため、サーバー変数にはできません。 デフォルト値はgermanで、タイプは文字列です。
- 完全なURLは
https://restcountries.com/{version}/lang/{language}になります。置換後(サーバー変数
{version}にv3.1、languageパス・パラメータにgerman)、これは、開始したインスタンスURLであるhttps://restcountries.com/v3.1/lang/germanを表します。
サーバーURLで変数(または複数の変数)を追加または変更する方法を次に示します:
- 新しいサーバー変数を追加する(または既存の変数を変更する)サーバー・インスタンスの右側にある「編集」
をインスタンスURLにクリックします。「編集サーバー」ダイアログが表示されます。 - 「説明」フィールドに説明を入力し、「デフォルト」フィールドにデフォルト値を設定します。終了したら「完了」をクリックするか、「+値の追加」をクリックして別の値を追加します。 複数の値を含むリストを作成するには、「メニュー」
をクリックし、「値リストの作成」を選択します。 次に、値を追加した後、
または
コントロールを使用してデフォルト値を設定するか、値リストを並べ替えます。 デフォルト値は、リストの先頭に表示されます。 「削除」 
を使用して、不要な値を破棄できます。