1. REST API

まで

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

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

さらなる要件に対応するために、接続範囲を広げることができるようになりました。この場合、クライアントはtakeパラメーターを指定することで、返される項目の範囲を判別できます。さらに、skipパラメーターを指定できます。これらのパラメータは、あいまいさを減らすために「ページインデックス」や「ページサイズ」の代わりに使用されます。範囲指定は、次の省略可能なパラメーターを含むURIテンプレートがある場合にのみ使用できます。

パラメーター

種類

形容

skip

Int

「スキップ」され、返されなかったアイテムの数。存在しない場合、項目はスキップされません。

take

Int

返される項目の最大数。サーバーの応答時間を改善するために、値は制限されています。値が大きすぎる場合、要求は403 Forbiddenまたは500 Internal Server Errorで拒否されます。制限は各リソースに設定されます。詳細については、リソースのドキュメントを参照してください。

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

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