4.4.1. Discovering an Application's URLs (アプリケーションの URL の発見)

4.4.1. Discovering an Application's URLs (アプリケーションの URL の発見)

一般に, クライアントは URL の発見を通じて特定のアプリケーションとの対話を開始します。これはいくつかの方法で発生する可能性があります, 次を含む:

• URL はユーザーまたは管理者によって手動で構成されます (例: 構成ファイル内);

• URL は発見メカニズムによって提供されます (例: リンク [WEB-LINKING] または既知の URL [WELL-KNOWN-URI]); または

• URL はテンプレート [URI-TEMPLATE] または同様のものを使用して他の情報から構築されます。

URL を使用するアプリケーションは, これらのメカニズムの 1 つ以上を明示的に指定すべきです。

たとえば:

クライアントは開始 URL で構成されます。

アプリケーションルートは既知の URL [WELL-KNOWN-URI] を使用して発見されます。

アプリケーションはリンク関係 [WEB-LINKING] を使用してリソース間を移動します。

仕様はアプリケーション URL の固定プレフィックスを定義すべきではありません (SHOULD NOT)。たとえば, そのプレフィックスがアプリケーションの機能に本当に必要でない限り, 常にパスプレフィックス /app を使用するプロトコルを定義することは悪い慣行です。このような制約は他の要件と競合する場合, 回避することが困難です。

ただし, 仕様は必要に応じて構造を定義できます。たとえば, 仕様はリソースがカテゴリとアイテム識別子の両方によって識別されることを要求する場合があり, 次のようなテンプレートを持つ可能性があります:

/{category}/{item}

この場合, アプリケーションは構成可能なベース URL を提供でき, このテンプレートをその下に適用できます。