Octopart API-Schnellstartanleitung

Die Octopart API ist eine GraphQL-API für Lieferkettendaten elektronischer Bauteile. Sie bietet Ihnen programmatischen Zugriff auf die Octopart-Datenbank – Bauteile, Preise, Lagerbestände, Distributor-Angebote, Hersteller-Lieferzeiten und mehr – über Millionen von Komponenten von Tausenden 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 beides, um ein Token anzufordern.

Schritt 2: Ein Zugriffstoken abrufen

Tauschen Sie Ihre Zugangsdaten mithilfe des OAuth 2.0-client_credentialsGrant 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 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 Authorization-Header:

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 die passenden 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 – Ablauf von Tokens, erneutes Anfordern von Tokens und Verwaltung von Zugangsdaten

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

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