Inventar

API-Inventar vs. octopart.com

Die von der API zurückgegebenen Inventardaten können von dem abweichen, was Sie auf octopart.com sehen. Dafür gibt es zwei Gründe:

• Data freshness – Die API liefert Inventardaten aus regelmäßig eingelesenen Distributor-Datenfeeds. octopart.com verwendet für einige Distributoren Live-Daten, die aktuellere Bestandsänderungen widerspiegeln können.

• Country defaulting – octopart.com erkennt das Land des Benutzers anhand seiner IP-Adresse und zeigt regionsgerechte Angebote an. Die API verwendet standardmäßig US, wenn kein Parameter country angegeben ist. Wenn Sie Anfragen für eine Nicht-US-Region stellen, übergeben Sie die Parameter country (und optional currency) immer explizit.

Abfrage von Inventardaten

Bestandsinformationen sind auf zwei Ebenen der Antwort verteilt:

• SupPart – die aggregierten Felder totalAvail und avgAvail fassen den Bestand über alle Verkäufer hinweg zusammen

• SupOffer – das Feld inventoryLevel gibt die Bestandsmenge für ein bestimmtes Angebot eines bestimmten Verkäufers an

query InventoryCheck {
  supSearchMpn(q: "LM358DR", limit: 2) {
    results {
      part {
        mpn
        totalAvail
        avgAvail
        sellers(includeBrokers: false) {
          company {
            name
          }
          isAuthorized
          offers {
            inventoryLevel
            updated
          }
        }
      }
    }
  }
}

Das Feld updated in SupOffer zeigt an, wann die Bestandsdaten zuletzt aus dem Feed des Distributors empfangen wurden, was bei der Beurteilung der Aktualität der Daten helfen kann.

inventoryLevel Sondercodes

inventoryLevel gibt normalerweise eine nicht negative Ganzzahl zurück, die die auf Lager befindlichen Einheiten angibt. Wenn ein Distributor keine exakte Menge angeben kann, wird stattdessen ein negativer Sondercode zurückgegeben:

totalAvail und avgAvail

totalAvail ist die Summe des Bestands über alle Distributoren hinweg; avgAvail ist der Durchschnitt pro Distributor. Beide Felder befinden sich in SupPart.

Broker-Bestand beeinflusst diese Werte auf eine bestimmte Weise: Wenn keine Standard-Distributoren Bestand haben, aber ein oder mehrere Broker inventoryLevel > 0 oder inventoryLevel == -2 haben, dann wird totalAvail auf 1 gesetzt. Die tatsächliche Menge des Brokers wird niemals numerisch addiert – es wird nur das Vorhandensein von Broker-Bestand signalisiert.

Das bedeutet, dass ein totalAvail von 1 ohne Bestand bei Standard-Distributoren ein Hinweis darauf ist, Broker-Angebote zu prüfen, und keine wörtliche Stückzahl.

Um in Ihrer Anwendung zwischen Distributoren und Brokern zu unterscheiden, verwenden Sie das Feld isBroker in SupPartSeller:

sellers(includeBrokers: true) {
  company { name }
  isAuthorized
  isBroker
  offers {
    inventoryLevel
  }
}