Guida rapida introduttiva all’API di Octopart

L'API Octopart è un'API GraphQL per i dati della supply chain dei componenti elettronici. Ti offre accesso programmatico al database Octopart – componenti, prezzi, livelli di inventario, offerte dei distributori, lead time di fabbrica e altro ancora – per milioni di componenti di migliaia di produttori e distributori in tutto il mondo.

Questa guida ti porta da zero alla tua prima query Octopart API in pochi minuti.

Prerequisiti

Un account su Altium Developer Center – il portale self-service di Altium per gli sviluppatori, dove puoi iscriverti ai programmi per accedere ad Altium 365 API, Octopart API, Altium Designer SDK, Embeddable Viewer e altri prodotti per sviluppatori

Passaggio 1: ottieni le credenziali

1. Accedi a portal.nexar.com.

2. Crea una nuova applicazione.

3. Copia il Client ID e il Client Secret – ti serviranno entrambi per richiedere un token.

Passaggio 2: ottieni un token di accesso

Scambia le tue credenziali con un token di accesso usando il grant OAuth 2.0 client_credentials:

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"

Una risposta riuscita sarà simile a questa:

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

Copia il valore access_token. I token scadono dopo un'ora – consulta Authentication per sapere come gestire il rinnovo del token nella tua applicazione.

Passaggio 3: esegui la tua prima query

Invia una query GraphQL all'endpoint usando il tuo token nell'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 } } } } }"
  }'

Una risposta riuscita restituisce i componenti corrispondenti:

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

Il campo hits mostra quanti componenti hanno trovato corrispondenza. Usa limit e start per scorrere i risultati per pagine – vedi Pagination in Octopart API.

Provalo nel browser

Puoi eseguire ed esplorare le query in modo interattivo nel Nitro IDE, disponibile direttamente all'endpoint GraphQL:

https://api.nexar.com/graphql

Per esplorare visivamente lo schema, apri il browser Voyager:

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

Passaggi successivi

• Authorization – scadenza del token, nuova richiesta dei token e gestione delle credenziali

• Search – corrispondenza MPN, ricerca per parole chiave, filtri, area geografica e valuta

• Example Queries – query pronte all'uso per casi d'uso comuni