Paginación

La API de Octopart utiliza paginación por límite/desplazamiento. No hay cursores: usted controla la ventana de resultados con dos parámetros: limit y start.

Parámetros

Cómo funciona

start es un desplazamiento de elementos, no un número de página. Para recuperar una página específica, multiplique el índice de página por limit:

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

El campo hits en la respuesta devuelve el número total de resultados coincidentes, que puede ser mayor que la cantidad que usted puede recuperar. El desplazamiento máximo alcanzable es 1000; no se puede acceder mediante paginación a los resultados que superen ese valor.

Ejemplos

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

Paginación a través de los resultados

Para recorrer todos los resultados, incremente start en limit hasta haber recuperado todos los elementos o alcanzar el límite de desplazamiento:

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 supera 1000, no se podrá acceder a los resultados restantes mediante paginación. En la práctica, reduzca el alcance de su consulta de búsqueda o aplique filtros para mantener el conjunto de resultados dentro del rango.