Paginierung

Die Octopart API verwendet eine Limit/Offset-Paginierung. Es gibt keine Cursor – Sie steuern den Ergebnisausschnitt mit zwei Parametern: limit und start.

Parameter

Funktionsweise

start ist ein Element-Offset, keine Seitennummer. Um eine bestimmte Seite abzurufen, multiplizieren Sie den Seitenindex mit limit:

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

Das Feld hits in der Antwort gibt die Gesamtzahl der übereinstimmenden Ergebnisse zurück, die größer sein kann als die Anzahl der Ergebnisse, die Sie abrufen können. Der maximal erreichbare Offset ist 1000 – Ergebnisse darüber hinaus sind über die Paginierung nicht zugänglich.

Beispiele

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

Durch Ergebnisse blättern

Um alle Ergebnisse zu durchlaufen, erhöhen Sie start um limit, bis Sie alle Elemente abgerufen haben oder das Offset-Limit erreicht ist:

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

Wenn hits 1000 überschreitet, sind die verbleibenden Ergebnisse über die Paginierung nicht erreichbar. In der Praxis sollten Sie Ihre Suchanfrage eingrenzen oder Filter anwenden, damit der Ergebnissatz im zulässigen Bereich bleibt.