Beispielabfragen

Region ändern

Viele unserer Vertriebspartner weisen je nach Land des Benutzers unterschiedliche Lagerbestände aus. Standardmäßig verwendet die API US und USD für Land und Währung, diese Werte können jedoch überschrieben werden, um Ergebnisse zu erhalten, die besser zu Ihrer Region passen.

Vergleichen Sie die Abfrage für Großbritannien:

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

... mit der Abfrage in den USA: 

query USMatch {
  supMultiMatch(
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

In diesem Fall waren an diesem bestimmten Tag 1.370 Teile für den Versand nach GB verfügbar. Benutzer in den USA hätten jedoch nur 300 verfügbare Teile gesehen.

Viele Distributoren liefern in mehrere Länder oder trennen ihre Bestände nicht nach Ländern. Daher werden das eingegebene Land und die Währung nicht als harter Filter verwendet.

Ländercodes folgen dem Standard ISO 3166 (Alpha-2); Währungscodes folgen dem Standard ISO 4217. 

Exakte mpn-Übereinstimmung mit bestimmten Lieferanten

Mit der SupMultiMatch Abfrage:

query MultiMatch {
  supMultiMatch(
    queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
    options: {filters: {distributor_id: ["459", "1106", "2401", "2628", "2454", "3261", "12947"]}}
  ) {
    hits
    parts {
      mpn
      name
      sellers {
        company {
          name
        }
        offers {
          prices {
            price
            currency
          }
        }
      }
    }
  }
}

Beachten Sie, dass dadurch nach Teilen gefiltert wird, die von den angegebenen Distributoren verkauft werden. Die Liste der Distributoren ist hier verfügbar. Wenn andere Distributoren dieses Teil ebenfalls verkaufen, werden sie ebenfalls aufgeführt. Falls gewünscht, können Sie diese bei der Verarbeitung jederzeit herausfiltern.

Statt der Unternehmens-ID, z. B. „459“, können Sie auch den Unternehmensnamen, z. B. „Digi-Key“, angeben. Hier ist ein Beispiel:

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

Teile von Verkäufern mit Preisinformationen

Hier ist eine Beispielabfrage, die Sie in Ihrer IDE verwenden können:

query FindPrices {
  supSearch(q: "AEC-Q100", limit: 3) { 
    results {
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices{
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

Exakte Teileübereinstimmung

Mit der supMultiMatch Abfrage können Sie mehrere MPNs eingeben, um Daten abzurufen; dabei wird für jede ein exakter Treffer gesucht.

query MatchParts {
  supMultiMatch(queries: [{mpn: "G3VM-101PR"}]) {
    hits
    reference
    parts {
      id
      slug
      mpn
      manufacturer {
        name
      }
    }
  }
}

Filterung nach lagernden Teilen

Bei der Suche können Sie festlegen, dass nur Teile einbezogen werden, die auf Lager sind. Zum Beispiel:

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

Wenn Sie diesen Filter auf true setzen, werden Teile ausgeschlossen, die no stock at all haben. Wenn ein Teil nur bei einem einzigen Distributor Lagerbestand hat, gilt es als auf Lager und wird als Teil der Abfrage zurückgegeben.

Diese Filterung berücksichtigt den Distributor-Bestand überhaupt nicht – sie wird auf Teilebene angewendet.

Hier ist ein Beispiel, das Sie ausprobieren können. Diese Abfrage sucht nach AEC-Q100 mit einer Paginierung start Seite von 5 und inStockOnly gesetzt auf true:

query in_stock_filter{
  supSearch(q: "AEC-Q100", start: 5, inStockOnly: true) { 
    results {
      
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
        }
      }
    }
  }
}

Unerwartet zurückgegebene MPNs

Beim Suchen oder Abgleichen werden manchmal zusätzliche Teile gefunden, bei denen sich die MPNs nur durch nicht alphanumerische Zeichen unterscheiden, wie z. B. - oder ..

Betrachten Sie zum Beispiel eine supMultiMatch Abfrage für die folgende MPN:

query MultiMatch {
  supMultiMatch(queries: {mpn: "ASV-18432MHZ-EJ-T", limit: 5}) {
    hits
    parts {
      mpn
    }
  }
}

Dies kann mehrere MPNs zurückgeben, z. B. ASV-18.432MHZ-EJ-T sowie ASV-1.8432MHZ-E-J-T (und andere).

Dieses Verhalten ist auf die Art und Weise zurückzuführen, wie Teile für die Indizierung in der Elasticsearch-Engine „tokenisiert“ werden.

MPNs werden in Tokens aufgeteilt, wobei Sonderzeichen ignoriert werden (z. B. könnte CV 3-200/SPG zu `CV`, `3200`, `SPG` werden).

Der Abgleich erfolgt dann mithilfe von Trigrammen (Dreierkombinationen von Buchstaben). Die Suche muss vollständig mit einer tokenisierten MPN übereinstimmen, partielle Übereinstimmungen hängen jedoch von Trigrammen ab. Zum Beispiel:

• Match: "CV 3-20", "CV 320", "00 SPG" - Each part aligns with at least one full token

• No Match: "CV 3", "CV 3-", "CV 32" - No part of these aligns with any token

Verwendung von Wildcards

Manchmal liefert die Suche nach einer teilweisen Teilenummer zu viele Teile, oder Sie haben spezielle Anforderungen an den Abgleich der Teilenummer. In diesen Fällen können Sie Wildcards verwenden, um Ihre Suche zu verfeinern.

• Das Zeichen * steht für eine beliebige Zeichenfolge (einschließlich null Zeichen).

• Das Zeichen ? steht für ein beliebiges einzelnes Zeichen.

Wildcards können an beliebiger Stelle innerhalb einer Teilenummer verwendet werden. Wildcards zu verwenden, um die Mitte einer Teilenummer zu finden, ist nicht erforderlich – führende und nachgestellte Wildcards werden automatisch hinzugefügt. Zum Beispiel liefert *74LS25* dieselben Ergebnisse wie 74LS25.

Wenn Sie einem Begriff ein oder mehrere Wildcards hinzufügen, werden keine weiteren Wildcards automatisch ergänzt. Dies kann für Präfixsuchen verwendet werden. Zum Beispiel findet lv40 Teile, die lv40 irgendwo in der Teilenummer enthalten, während lv40* nur Teile findet, die mit lv40 beginnen.

Factory Lead Time für Teile

Es gibt zwei Felder, die Sie in der API abfragen können.

1. factoryLeadDays auf SupOffer gibt die Anzahl der Tage zurück, die benötigt werden, um Teile vom Hersteller zu beschaffen.

2. estimatedFactoryLeadDays auf SupPart gibt die geschätzte Factory Lead Time in Tagen zurück, abgeleitet aus Angeboten vertrauenswürdiger Distributoren.

Hier ist eine Beispielabfrage für autorisierte Verkäufer:

query LeadDaysSearch {
  supSearch(q: "IRL3803STRLPBF", limit: 2) {
    results {
      part {
        mpn
        estimatedFactoryLeadDays
        sellers(authorizedOnly: true) {
          offers {
            factoryLeadDays
          }
        }
      }
    }
  }
}

Ähnliche Teile

Beim Suchen oder Abgleichen von Teilen können Sie angeben, dass similarParts zurückgegeben werden soll. Dabei handelt es sich um Teile, die von Nexar als in Spezifikation und Funktionalität ähnlich identifiziert wurden. Hier ist eine Beispielabfrage:

query SimilarParts {
  supSearch(q: "LM339MX", limit: 1) {
    hits
    results {
      part {
        id
        mpn
        name
        manufacturer { name }
        similarParts {
          id
          mpn
          manufacturer { name }
        }
      }
    }
  }
}