4.2. リンクの要素

エントリーポイントにアクセスすると、API が公開するすべてのリソースコレクションの link 要素と URI が提供されます。コレクションには、リレーションタイプを使用して、クライアントが必要とする URI を特定します。

link 要素には、 特定のコレクションの search URI セットも含まれます。これらの URI は URI テンプレート ^[4] を使って検索クエリーを統合します。URI テンプレートの目的はクエリーパラメーターの自然な HTTP パターンを使って検索式を受け入れることです。クライアントには、URI 構造に関する予備知識は必要ありません。したがって、クライアントはこれらのテンプレートが不透明であるものとして扱い、URI テンプレートライブラリーを使用してアクセスする必要があります。

各検索クエリーの URI テンプレートは、"collection/search" の形式を使用したリレーションタイプで特定されます。