コレクション・リソースの使用

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

コレクションリソースは、他のリソースを含むリソースです。それ自体がファーストクラスのリソースであるため、コレクションリソースと呼ばれます。これには、含まれるインスタンスに加えて、他のリソースと同様の独自の属性があります。複数のリソースと対話する場合は、コレクションリソースを使用する必要があります。

コレクションリソースを使用して、レスポンスを検索、ソート、およびページ分割できます。

コレクションリソースを使用するには、コレクションリソースのUniform Resource Identifier (URI) に対してGET要求を行います。

次の表では、コレクションリソースの属性について説明します。

属性	種類	形容
href	糸	コレクションリソースの完全修飾ロケーションURIです。
limit	整数	1つの要求に対して返すコレクション項目の最大数。最小値は1です。最大値は100です。デフォルト値は10です。これはページネーション固有の属性です。
items	配列	リソースの現在のページを含む配列。この配列のサイズは、要求の制限が許容される最大値より大きい場合など、要求された制限よりも小さくすることができます。これは、応答が合計コレクションの最終ページを表し、最終ページの項目数が制限を下回っている場合にも適用されます。これはページネーション固有の属性です。

この記事を改善するための提案がある場合は、お知らせください!