ページネーション

Octopart API は、limit/offset 方式のページネーションを使用します。カーソルはありません。結果の表示範囲は、2 つのパラメーター limit と start で制御します。

パラメーター

仕組み

start はページ番号ではなく、アイテムのオフセットです。特定のページを取得するには、ページインデックスに limit を掛けます。

start = page * limit   (where page 0 is the first page)

レスポンス内の hits フィールドは、一致した結果の総数を返します。これは、実際に取得可能な件数より多い場合があります。到達可能なオフセットの最大値は 1000 であり、それを超える結果にはページネーションではアクセスできません。

例

Return 15 results from the beginning:

query FirstPage {
  supSearchMpn(q: "acs770", limit: 15) {
    hits
    results {
      part {
        id
        mpn
      }
    }
  }
}

Return the next page (items 15–29):

query SecondPage {
  supSearchMpn(q: "acs770", limit: 15, start: 15) {
    hits
    results {
      part {
        id
        mpn
      }
    }
  }
}

結果を順にページングする

すべての結果を順に取得するには、全アイテムを取得するか、オフセット上限に達するまで、start を limit ずつ増やします。

page 0: start=0,   limit=100
page 1: start=100, limit=100
page 2: start=200, limit=100
...
page 9: start=900, limit=100   ← last reachable page at max limit

hits が 1000 を超える場合、残りの結果にはページネーションでは到達できません。実際には、検索クエリを絞り込むかフィルターを適用して、結果セットを取得可能な範囲内に収めてください。