Pagination

L’API Octopart utilise une pagination par limite/décalage. Il n’y a pas de curseurs : vous contrôlez la fenêtre sur les résultats avec deux paramètres : limit et start.

Paramètres

Fonctionnement

start est un décalage d’élément, et non un numéro de page. Pour récupérer une page spécifique, multipliez l’index de page par limit :

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

Le champ hits dans la réponse renvoie le nombre total de résultats correspondants, qui peut être supérieur à ce que vous pouvez récupérer. Le décalage maximal atteignable est de 1000 ; les résultats au-delà ne sont pas accessibles via la pagination.

Exemples

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

Pagination des résultats

Pour parcourir tous les résultats, incrémentez start de limit jusqu’à avoir récupéré tous les éléments ou atteint la limite de décalage :

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

Si hits dépasse 1000, les résultats restants ne sont pas accessibles via la pagination. En pratique, affinez votre requête de recherche ou appliquez des filtres pour maintenir l’ensemble de résultats dans cette plage.