範囲設定
範囲設定
さらに多くの要件に対応できるように、接続の範囲を設定できるようになりました。この場合、クライアントは、take パラメーターを指定することによって返されるアイテムの範囲を決定できます。また、skip パラメーターを指定できます。これらのパラメーターは、あいまいさを解消するために 'ページのインデックス' および 'ページ サイズ' の代わりとして使用されます。範囲設定は、次の任意のパラメーターを含む URI テンプレートがある場合にのみ使用できます。
| パラメーター | タイプ | 説明 |
|---|---|---|
skip | Int | 'スキップ' されて返されていないアイテムの数。存在しない場合、スキップされるアイテムはありません。 |
take | Int | 返されるアイテムの最大数。サーバーの応答時間を改善するため、値に制限されます。値が高すぎる場合、403 Forbidden または 500 Internal Server Error と表示されて要求が拒否されます。制限はリソースごとに設定されます。詳細については、リソースのドキュメントを参照してください。 |
take パラメーターの存在が必要であることに注意する必要があります。take パラメーターが指定されていない場合、範囲設定は使用されず、チャンクが有効になる可能性があります。チャンクはその URL 内に同じ skip パラメーターを使用する場合と使用しない場合がありますが、これはクライアントの範囲外であり、この場合に skip パラメーターの変更はサポートされていません。