Paginação

A API do Octopart usa paginação por limite/deslocamento. Não há cursores — você controla a janela dos resultados com dois parâmetros: limit e start.

Parâmetros

Como Funciona

start é um deslocamento de item, não um número de página. Para recuperar uma página específica, multiplique o índice da página por limit:

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

O campo hits na resposta retorna o número total de resultados correspondentes, que pode ser maior do que o que você consegue recuperar. O deslocamento máximo alcançável é 1000 — resultados além disso não ficam acessíveis por meio da paginação.

Exemplos

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
      }
    }
  }
}

Paginando pelos Resultados

Para percorrer todos os resultados, incremente start em limit até ter recuperado todos os itens ou atingido o limite de deslocamento:

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

Se hits exceder 1000, os resultados restantes não poderão ser acessados por meio da paginação. Na prática, restrinja sua consulta de busca ou aplique filtros para manter o conjunto de resultados dentro desse intervalo.