Paginazione

L'API Octopart utilizza la paginazione limit/offset. Non ci sono cursori: controlli la finestra dei risultati con due parametri: limit e start.

Parametri

Come funziona

start è un offset di elementi, non un numero di pagina. Per recuperare una pagina specifica, moltiplica l'indice di pagina per limit:

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

Il campo hits nella risposta restituisce il numero totale di risultati corrispondenti, che può essere maggiore di quanto puoi recuperare. L'offset massimo raggiungibile è 1000: i risultati oltre tale valore non sono accessibili tramite paginazione.

Esempi

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

Scorrimento dei risultati

Per iterare attraverso tutti i risultati, incrementa start di limit finché non hai recuperato tutti gli elementi o non hai raggiunto il limite di offset:

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 supera 1000, i risultati rimanenti non sono accessibili tramite paginazione. In pratica, restringi la query di ricerca o applica filtri per mantenere il set di risultati entro l'intervallo consentito.