1. 範囲設定

範囲設定

さらに多くの要件に対応できるように、接続の範囲を設定できるようになりました。 この場合、クライアントは、take パラメーターを指定することによって返されるアイテムの範囲を決定できます。 また、skip パラメーターを指定できます。 これらのパラメーターは、あいまいさを解消するために「ページのインデックス」および「ページ サイズ」の代わりとして使用されます。 範囲設定は、次の任意のパラメーターを含む URI テンプレートがある場合にのみ使用できます。

パラメーター説明
skipInt「スキップ」されて返されていないアイテムの数。 存在しない場合、スキップされるアイテムはありません。
takeInt返されるアイテムの最大数。 サーバーの応答時間を改善するため、値に制限されます。 値が高すぎる場合、403 Forbidden または 500 Internal Server Error と表示されて要求が拒否されます。 制限はリソースごとに設定されます。 詳細については、リソースのドキュメントを参照してください。

take パラメーターの存在が必要であることに注意する必要があります。 take パラメーターが指定されていない場合、範囲設定は使用されず、チャンクが有効になる可能性があります。 チャンクはその URL 内に同じ skip パラメーターを使用する場合と使用しない場合がありますが、これはクライアントの範囲外であり、この場合に skip パラメーターの変更はサポートされていません

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