검색

Octopart API는 부품 검색을 위한 세 가지 쿼리를 제공합니다. 어떤 쿼리를 선택할지는 찾고 있는 부품에 대해 무엇을 알고 있는지에 따라 달라집니다.

MPN 매칭

supMultiMatch – Batch Exact Match

supMultiMatch MPN 또는 SKU 목록을 받아 각각에 대해 가장 적합한 일치 결과를 반환합니다. 부품 번호를 알고 있고, 한 번의 요청으로 여러 부품을 조회해야 할 때 적합한 선택입니다.

query MatchParts {
  supMultiMatch(queries: [{ mpn: "LM358DR" }, { mpn: "LM339MX" }]) {
    hits
    parts {
      mpn
      manufacturer {
        name
      }
      sellers {
        company {
          name
        }
        offers {
          inventoryLevel
          prices {
            price
            currency
            quantity
          }
        }
      }
    }
  }
}

queries의 각 요소에는 해당 MPN에 대해 반환할 일치 부품 수를 제어하기 위한 자체 limit를 포함할 수 있습니다.

supSearchMpn – 단일 MPN 검색

supSearchMpn은 단일 쿼리 문자열을 받아 MPN 일치 결과를 순위별로 반환합니다. 한 번에 하나의 부품을 검색할 때 사용합니다.

query FindByMpn {
  supSearchMpn(q: "LM358", limit: 5) {
    hits
    results {
      part {
        mpn
        manufacturer {
          name
        }
      }
    }
  }
}

키워드 검색

supSearch은 부품 설명, 사양, 카테고리 전반에 걸쳐 더 폭넓은 검색을 수행합니다. 정확한 MPN이 없을 때, 예를 들어 부품 유형과 전기적 특성으로 검색할 때 사용합니다.

query FindCapacitors {
  supSearch(q: "100nF 50V 0402 ceramic", limit: 3) {
    hits
    results {
      part {
        mpn
        shortDescription
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices {
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

q 문자열은 부품 설명, 카테고리 및 인덱싱된 속성과 매칭됩니다. 속성 기반 필터링(예: 정확한 정전용량 또는 정격 전압)에는 filters 파라미터를 사용하세요. 자세한 내용은 사용 가능한 필터 속성을 참조하세요.

결과 필터링

재고 보유 필터

어느 유통업체에도 재고가 없는 부품을 제외하려면 inStockOnly: true를 전달하세요. 이 필터는 부품 수준에서 적용되므로, 단 하나의 유통업체에라도 재고가 있으면 해당 부품은 재고 보유로 간주됩니다.

supSearch(q: "LM339", limit: 10, inStockOnly: true) { ... }

공인 판매자만

중개업자 및 그레이마켓 판매자를 제외하고 공인 유통업체만 반환하려면 authorizedOnly: true 필드에 sellers를 전달하세요.

sellers(authorizedOnly: true) {
  company { name }
  offers { inventoryLevel }
}

유통업체로 필터링

특정 유통업체로 결과 범위를 제한하려면 options.filters.distributor_id를 사용하세요. 유통업체의 숫자 ID 또는 이름을 전달할 수 있습니다:

query MultiMatch {
  supMultiMatch(
    queries: [{ mpn: "FH12-5S-1SH(55)", limit: 2 }]
    options: { filters: { distributor_id: ["Digi-Key", "Mouser"] } }
  ) {
    hits
    parts {
      mpn
      sellers {
        company { name }
        offers {
          prices { price currency }
        }
      }
    }
  }
}

유통업체 ID 전체 목록은 octopart.com/api/v4/values에서 확인할 수 있습니다.

지역 및 통화

많은 유통업체는 구매자의 국가에 따라 서로 다른 재고 수준을 제공합니다. 국가와 통화가 지정되지 않으면 API는 기본적으로 US 및 USD를 사용합니다.

지역에 맞는 결과를 얻으려면 쿼리 수준에서 country 및 currency를 전달하세요:

query GBMatch {
  supMultiMatch(
    country: "GB"
    currency: "GBP"
    queries: [{ mpn: "LM358DR", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company { name }
        offers { inventoryLevel }
      }
    }
  }
}

국가 코드는 ISO 3166 alpha-2를, 통화 코드는 ISO 4217를 따릅니다.

많은 유통업체가 여러 국가로 배송하거나 국가별로 재고를 구분하지 않기 때문에, country 및 currency는 엄격한 필터가 아닙니다. 대신 어떤 오퍼가 노출될지와 그 가격에 영향을 줍니다.

와일드카드

부분 부품 번호 매칭에서 결과가 너무 많이 반환되는 경우, 와일드카드를 사용해 검색 범위를 좁힐 수 있습니다:

기본적으로 앞뒤 와일드카드가 자동으로 추가되므로 74LS25와 *74LS25*는 동일한 결과를 반환합니다.

와일드카드를 하나라도 명시적으로 추가하면 자동 와일드카드는 not 추가되지 않습니다. 이는 접두사 검색에 유용합니다:

lv40    → matches anything containing "lv40" (wildcards added automatically)
lv40*   → matches only parts starting with "lv40"

결과에 예상치 못한 MPN이 포함되는 경우

MPN 매칭을 사용할 때, 검색한 MPN과 달라 보이는 MPN을 가진 부품이 가끔 반환될 수 있습니다. 이는 검색 엔진이 부품 번호를 토큰화하고 인덱싱하는 방식 때문에 발생하는 정상적인 동작입니다.

검색 인덱스를 만들 때 - 및 . 같은 영숫자가 아닌 문자는 무시됩니다. 그 후 매칭은 트라이그램(3자 문자 시퀀스)을 사용해 수행됩니다. 예를 들어 ASV-18432MHZ-EJ-T를 검색하면 두 값이 동일한 트라이그램 집합으로 토큰화되므로 ASV-18.432MHZ-EJ-T도 반환될 수 있습니다.

If an exact character match is required반환된 MPN을 입력값과 비교하고, 애플리케이션에서 결과를 필터링하세요.

주요 응답 필드