Guida rapida all'API di Octopart

L'API Octopart è un'API GraphQL per i dati della catena di approvvigionamento dei componenti elettronici. Offre accesso programmatico al database Octopart (componenti, prezzi, livelli di scorte, offerte dei distributori, tempi di consegna del produttore e molto altro) per milioni di componenti di migliaia di produttori e distributori in tutto il mondo.

Questa guida ti accompagna da zero alla tua prima query all'API Octopart 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 Client ID e Client Secret – ti serviranno entrambi per richiedere un token.

Your Client Secret is shown once. Conservalo in modo sicuro prima di lasciare la pagina.

Passaggio 2: ottieni un token di accesso

Scambia le tue credenziali con un token di accesso utilizzando il tipo di concessione client_credentials di OAuth 2.0:

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 con esito positivo ha questo aspetto:

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

Copia il valore di access_token. I token scadono dopo 24 ore: consulta la sezione Autenticazione per sapere come gestire il rinnovo dei token nella tua applicazione.

Passaggio 3: esegui la tua prima query

Invia una query GraphQL all'endpoint utilizzando il tuo token nell'intestazione 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 con esito positivo restituisce i componenti corrispondenti:

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

Il campo hits indica quanti componenti corrispondono ai criteri di ricerca. Usa limit e start per scorrere le pagine dei risultati: consulta Paginazione nell'API Octopart. Consulta supSearchMpn  nella Guida di riferimento dell'API Octopart per tutti i relativi filtri e le opzioni di ordinamento e aggregazione.

Prova nel browser

Puoi eseguire ed esplorare le query in modo interattivo nell'IDE Nitro, 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

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.
Contents
Contents