Szukaj

API Octopart udostępnia trzy rodzaje zapytań do wyszukiwania części. Wybór właściwego zależy od tego, co wiesz o szukanej części.

Dopasowanie MPN

supMultiMatch – Batch Exact Match

supMultiMatch przyjmuje listę numerów MPN lub SKU i zwraca najlepsze dopasowanie dla każdego z nich. To właściwy wybór, gdy znasz numery części i chcesz wyszukać wiele części w jednym żądaniu.

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

Każdy element w queries może zawierać własny parametr limit, aby określić, ile dopasowanych części ma zostać zwróconych dla danego MPN.

supSearchMpn – wyszukiwanie pojedynczego MPN

supSearchMpn przyjmuje pojedynczy ciąg zapytania i zwraca uszeregowane wyniki dopasowania MPN. Użyj go, gdy wyszukujesz jedną część naraz.

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

Wyszukiwanie słów kluczowych

supSearch wykonuje szersze wyszukiwanie w opisach części, specyfikacjach i kategoriach. Użyj go, gdy nie masz dokładnego numeru MPN – na przykład podczas wyszukiwania według typu komponentu i parametrów elektrycznych.

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

Ciąg q jest dopasowywany do opisów części, kategorii i indeksowanych atrybutów. Do filtrowania opartego na atrybutach (np. dokładna pojemność lub napięcie znamionowe) użyj parametru filters – zobacz dostępne atrybuty filtrowania.

Filtrowanie wyników

Filtr dostępności w magazynie

Przekaż inStockOnly: true, aby wykluczyć części, których nie ma w magazynie u żadnego dystrybutora. Filtr działa na poziomie części – część dostępna u choćby jednego dystrybutora jest uznawana za dostępną w magazynie.

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

Tylko autoryzowani sprzedawcy

Przekaż authorizedOnly: true w polu sellers, aby zwrócić tylko autoryzowanych dystrybutorów, z wykluczeniem brokerów i sprzedawców z szarego rynku.

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

Filtruj według dystrybutora

Użyj options.filters.distributor_id, aby ograniczyć wyniki do określonych dystrybutorów. Możesz przekazać identyfikator numeryczny dystrybutora albo jego nazwę:

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

Pełna lista identyfikatorów dystrybutorów jest dostępna pod adresem octopart.com/api/v4/values.

Region i waluta

Wielu dystrybutorów udostępnia różne poziomy stanów magazynowych w zależności od kraju kupującego. Jeśli kraj i waluta nie zostaną określone, API domyślnie używa US i USD.

Przekaż country i currency na poziomie zapytania, aby uzyskać wyniki odpowiednie dla danego regionu:

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

Kody krajów są zgodne z ISO 3166 alpha-2; kody walut są zgodne z ISO 4217.

Pamiętaj, że wielu dystrybutorów wysyła do wielu krajów albo nie rozdziela stanów magazynowych według kraju, więc country i currency nie są ścisłym filtrem – wpływają na to, które oferty są prezentowane i jakie mają ceny.

Symbole wieloznaczne

Gdy dopasowywanie częściowych numerów części zwraca zbyt wiele wyników, symbole wieloznaczne pozwalają zawęzić wyszukiwanie:

Domyślnie symbole wieloznaczne na początku i końcu są dodawane automatycznie – więc 74LS25 i *74LS25* zwracają te same wyniki.

Jeśli jawnie dodasz jakikolwiek symbol wieloznaczny, automatyczne symbole wieloznaczne not są dodawane. Jest to przydatne przy wyszukiwaniu prefiksowym:

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

Nieoczekiwane numery MPN w wynikach

Podczas korzystania z dopasowania MPN możesz czasami otrzymać części, których numery MPN wyglądają inaczej niż ten, którego szukano. To oczekiwane zachowanie wynikające ze sposobu, w jaki wyszukiwarka tokenizuje i indeksuje numery części.

Znaki niealfanumeryczne (takie jak - i .) są ignorowane podczas budowania indeksu wyszukiwania. Dopasowanie jest następnie wykonywane z użyciem trigramów (trójelementowych sekwencji znaków). Na przykład wyszukiwanie ASV-18432MHZ-EJ-T może również zwrócić ASV-18.432MHZ-EJ-T, ponieważ oba są tokenizowane do tego samego zestawu trigramów.

If an exact character match is requiredAby temu zapobiec, porównaj zwrócone numery MPN z danymi wejściowymi i przefiltruj wyniki w swojej aplikacji.

Kluczowe pola odpowiedzi