Octopart API-Schnellstartanleitung

Die Octopart API ist eine GraphQL-API für Lieferkettendaten zu elektronischen Bauteilen. Sie bietet programmatischen Zugriff auf die Octopart-Datenbank – Bauteile, Preise, Lagerbestände, Distributor-Angebote, Fertigungsvorlaufzeiten und mehr – für Millionen von Komponenten von Tausenden von Herstellern und Distributoren weltweit.

Diese Anleitung bringt Sie in wenigen Minuten von null zu Ihrer ersten Octopart API-Abfrage.

Voraussetzungen

Ein Konto im Altium Developer Center – Altiums Self-Service-Portal für Entwickler, in dem Sie sich für Programme registrieren können, um Zugriff auf die Altium 365 API, die Octopart API, das Altium Designer SDK, den Embeddable Viewer und andere Entwicklerprodukte zu erhalten

Schritt 1: Zugangsdaten abrufen

1. Melden Sie sich bei portal.nexar.com an.

2. Erstellen Sie eine neue Anwendung.

3. Kopieren Sie die Client ID und Client Secret – Sie benötigen beide, um ein Token anzufordern.

Schritt 2: Ein Zugriffstoken abrufen

Tauschen Sie Ihre Zugangsdaten mithilfe des OAuth 2.0-client_credentials Grants gegen ein Zugriffstoken aus:

curl -X POST https://identity.nexar.com/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET" \
  -d "scope=supply.domain"

Eine erfolgreiche Antwort sieht wie folgt aus:

{
  "access_token": "eyJhbGci...",
  "expires_in": 86400,
  "token_type": "Bearer"
}

Kopieren Sie den Wert von access_token. Tokens laufen nach einer Stunde ab – unter Authentifizierung erfahren Sie, wie Sie die Token-Aktualisierung in Ihrer Anwendung handhaben.

Schritt 3: Führen Sie Ihre erste Abfrage aus

Senden Sie eine GraphQL-Abfrage an den Endpunkt und verwenden Sie dabei Ihr Token im Header Authorization:

curl -X POST https://api.nexar.com/graphql \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { supSearchMpn(q: \"LM358\", limit: 3) { hits results { part { mpn manufacturer { name } } } } }"
  }'

Eine erfolgreiche Antwort gibt passende Bauteile zurück:

{
  "data": {
    "supSearchMpn": {
      "hits": 42,
      "results": [
        {
          "part": {
            "mpn": "LM358DR",
            "manufacturer": { "name": "Texas Instruments" }
          }
        }
      ]
    }
  }
}

Das Feld hits zeigt an, wie viele Bauteile übereinstimmen. Verwenden Sie limit und start, um durch die Ergebnisse zu blättern – siehe Paginierung in der Octopart API.

Im Browser ausprobieren

Sie können Abfragen interaktiv in der Nitro IDE ausführen und erkunden, die direkt am GraphQL-Endpunkt verfügbar ist:

https://api.nexar.com/graphql

Um das Schema visuell zu erkunden, öffnen Sie den Voyager-Browser:

https://api.nexar.com/ui/voyager

Nächste Schritte

• Autorisierung – Token-Ablauf, erneutes Anfordern von Tokens und Verwalten von Zugangsdaten

• Suche – MPN-Abgleich, Stichwortsuche, Filter, Region und Währung

• Beispielabfragen – sofort einsetzbare Abfragen für häufige Anwendungsfälle