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
-
Accedi a portal.nexar.com.
-
Crea una nuova applicazione.
-
Copia Client ID e 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 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
-
Consulta la Guida di riferimento dell'API Octopart: tutte le query e tutti i tipi, raggruppati per area.
-
Autorizzazione – scadenza dei token, nuove richieste di token e gestione delle credenziali
-
Ricerca – corrispondenza MPN, ricerca per parole chiave, filtri, regione e valuta
-
Query di esempio – query pronte all'uso per i casi d'uso più comuni
-
Integra la ricerca dei componenti nel tuo sito con lo Stock Locator Tool, oppure esplora l'app demo dell'API Octopart.