페이지 매김

Octopart API는 limit/offset 페이지네이션을 사용합니다. 커서는 없으며, 결과 창은 두 개의 매개변수(limit 및 start)로 제어합니다.

매개변수

작동 방식

start은 페이지 번호가 아니라 항목 오프셋입니다. 특정 페이지를 가져오려면 페이지 인덱스에 limit을 곱합니다:

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

응답의 hits 필드는 일치하는 전체 결과 수를 반환하며, 이 수는 실제로 가져올 수 있는 수보다 클 수 있습니다. 도달 가능한 최대 오프셋은 1000이며, 그 이후의 결과는 페이지네이션으로 접근할 수 없습니다.

예제

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

결과 페이지 이동

모든 결과를 순회하려면 모든 항목을 가져오거나 오프셋 한도에 도달할 때까지 start을(를) limit만큼 증가시키세요:

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

hits이(가) 1000을 초과하면 나머지 결과에는 페이지네이션으로 접근할 수 없습니다. 실제로는 검색 쿼리를 더 구체화하거나 필터를 적용해 결과 집합이 범위 내에 들어오도록 해야 합니다.