クエリ結果のページ分割を処理する
大量の結果を返す可能性がある多くのAlexa REST APIでは、ページ分割が行われます。これらは、結果のサブセットである「ページ」と、結果の次のページの取得方法に関する情報を持つpaginationContext
オブジェクトを返します。以下の例は、一般的な形式のpaginationContext
オブジェクトを示しています。
{
"paginationContext": {
"nextToken": "{トークン}"
},
"results": [
{
...
}
]
}
以下の表に、paginationContext
オブジェクトに含まれるフィールドを示します。
フィールド | 説明 | 型 | 必須 |
---|---|---|---|
|
追加の結果を取得するためのトークンです。この値が存在しない場合は、これ以上結果がないことを示します。 |
|
✕ |
ページサイズを制限する
ページサイズを制限するには、以下の例に示すように、リクエストにmaxResults
クエリパラメーターを追加します。
GET /{resources}?maxResults=10
結果の次のページをリクエストする
結果のページをリクエストした後、結果の次のページを取得するには、新しいGET
リクエストを送信する必要があります。新しいリクエストは、前回と同じリクエストにnextToken
クエリパラメーターを追加したものでなければなりません。そのクエリパラメーターには、前回のリクエストへの応答で受け取ったnextToken
値を設定します。
応答にはこのトークンから始まる結果が返され、さらに続きの結果がある場合にのみnextToken
値が含められます。
ページサイズを制限して結果の次のページをリクエストするためのリクエストクエリパラメーター
以下の表に、ページサイズを制限し、結果の次のページをリクエストするためのクエリパラメーターフィールドを示します。
フィールド | 説明 | 型 | 必須 |
---|---|---|---|
|
応答本文で返される結果の最大数です。10以下の正の値を指定してください。 |
|
◯ |
|
ページ分割された結果から特定のページを取得するためのトークンです。このトークンがない場合、応答には結果の最初のページが含められます。 |
|
✕ |
最終更新日: 2023 年 03 月 16 日