Suche

Die Octopart API bietet drei Abfragen zum Finden von Teilen. Welche die richtige ist, hängt davon ab, was Sie über das gesuchte Teil wissen.

MPN Matching

supMultiMatch – Batch Exact Match

supMultiMatch akzeptiert eine Liste von MPNs oder SKUs und gibt für jede die beste Übereinstimmung zurück. Dies ist die richtige Wahl, wenn Sie die Teilenummern kennen und mehrere Teile in einer einzigen Anfrage nachschlagen möchten.

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

Jedes Element in queries kann ein eigenes limit enthalten, um zu steuern, wie viele passende Teile für diese MPN zurückgegeben werden.

supSearchMpn – Single MPN Search

supSearchMpn akzeptiert einen einzelnen Abfrage-String und gibt nach Relevanz sortierte MPN-Match-Ergebnisse zurück. Verwenden Sie diese Abfrage, wenn Sie jeweils nach nur einem Teil suchen.

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

Keyword Search

supSearch führt eine breitere Suche über Teilebeschreibungen, Spezifikationen und Kategorien hinweg durch. Verwenden Sie diese Abfrage, wenn Sie keine exakte MPN haben – zum Beispiel bei der Suche nach Bauteiltyp und elektrischen Eigenschaften.

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

Der String q wird mit Teilebeschreibungen, Kategorien und indexierten Attributen abgeglichen. Für attributbasierte Filterung (z. B. exakte Kapazität oder Nennspannung) verwenden Sie den Parameter filters – siehe verfügbare Filterattribute.

Ergebnisse filtern

Filter für lagernde Teile

Übergeben Sie inStockOnly: true, um Teile auszuschließen, die bei keinem Distributor auf Lager sind. Der Filter wird auf Teileebene angewendet – ein Teil gilt bereits dann als auf Lager, wenn es bei nur einem Distributor verfügbar ist.

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

Nur autorisierte Verkäufer

Übergeben Sie authorizedOnly: true im Feld sellers, um nur autorisierte Distributoren zurückzugeben und Broker sowie Graumarkt-Anbieter auszuschließen.

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

Nach Distributor filtern

Verwenden Sie options.filters.distributor_id, um die Ergebnisse auf bestimmte Distributoren einzugrenzen. Sie können entweder die numerische ID des Distributors oder seinen Namen übergeben:

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

Die vollständige Liste der Distributor-IDs ist unter octopart.com/api/v4/values verfügbar.

Region und Währung

Viele Distributoren geben je nach Land des Käufers unterschiedliche Lagerbestände an. Standardmäßig verwendet die API US und USD, wenn kein Land und keine Währung angegeben sind.

Übergeben Sie country und currency auf Abfrageebene, um regionsgerechte Ergebnisse zu erhalten:

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

Ländercodes folgen ISO 3166 alpha-2; Währungscodes folgen ISO 4217.

Beachten Sie, dass viele Distributoren in mehrere Länder liefern oder ihre Bestände nicht nach Ländern trennen, daher sind country und currency kein harter Filter – sie beeinflussen, welche Angebote angezeigt werden und zu welchen Preisen.

Wildcards

Wenn die Suche nach unvollständigen Teilenummern zu viele Ergebnisse liefert, können Sie die Suche mit Wildcards eingrenzen:

Standardmäßig werden führende und nachgestellte Wildcards automatisch hinzugefügt – daher liefern 74LS25 und *74LS25* dieselben Ergebnisse.

Wenn Sie selbst eine Wildcard explizit hinzufügen, werden automatische Wildcards not hinzugefügt. Das ist für Präfixsuchen nützlich:

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

Unerwartete MPNs in den Ergebnissen

Bei der Verwendung von MPN Matching erhalten Sie gelegentlich Teile, deren MPNs anders aussehen als die, nach der Sie gesucht haben. Dieses Verhalten ist zu erwarten und wird dadurch verursacht, wie die Suchmaschine Teilenummern tokenisiert und indexiert.

Nicht alphanumerische Zeichen (wie - und .) werden beim Aufbau des Suchindex ignoriert. Der Abgleich erfolgt dann mithilfe von Trigrammen (Dreier-Zeichenfolgen). Zum Beispiel kann eine Suche nach ASV-18432MHZ-EJ-T auch ASV-18.432MHZ-EJ-T zurückgeben, weil beide in dieselbe Menge von Trigrammen zerlegt werden.

If an exact character match is requiredVergleichen Sie die zurückgegebenen MPNs mit Ihrer Eingabe und filtern Sie die Ergebnisse in Ihrer Anwendung.

Wichtige Antwortfelder