Cerca

L'API Octopart offre tre query per trovare componenti. La scelta di quella giusta dipende da ciò che sai del componente che stai cercando.

Corrispondenza MPN

supMultiMatch – Batch Exact Match

supMultiMatch accetta un elenco di MPN o SKU e restituisce la corrispondenza migliore per ciascuno. È la scelta giusta quando conosci i codici dei componenti e devi cercare più componenti in un'unica richiesta.

query MatchParts {
  supMultiMatch(queries: [{ mpn: "LM358DR" }, { mpn: "LM339MX" }]) {
    hits
    parts {
      mpn
      manufacturer {
        name
      }
      sellers {
        company {
          name
        }
        offers {
          inventoryLevel
          prices {
            price
            currency
            quantity
          }
        }
      }
    }
  }
}

Ogni elemento in queries può includere il proprio limit per controllare quanti componenti corrispondenti vengono restituiti per quell'MPN.

supSearchMpn – Ricerca singolo MPN

supSearchMpn accetta una singola stringa di query e restituisce risultati ordinati per corrispondenza MPN. Usala quando cerchi un componente alla volta.

query FindByMpn {
  supSearchMpn(q: "LM358", limit: 5) {
    hits
    results {
      part {
        mpn
        manufacturer {
          name
        }
      }
    }
  }
}

Ricerca per parola chiave

supSearch esegue una ricerca più ampia tra descrizioni dei componenti, specifiche e categorie. Usala quando non hai un MPN esatto, ad esempio quando cerchi per tipo di componente e caratteristiche elettriche.

query FindCapacitors {
  supSearch(q: "100nF 50V 0402 ceramic", limit: 3) {
    hits
    results {
      part {
        mpn
        shortDescription
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices {
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

La stringa q viene confrontata con descrizioni dei componenti, categorie e attributi indicizzati. Per il filtraggio basato su attributi (ad es. capacità esatta o tensione nominale), usa il parametro filters – vedi attributi di filtro disponibili.

Filtraggio dei risultati

Filtro disponibilità a magazzino

Passa inStockOnly: true per escludere i componenti che non hanno stock presso alcun distributore. Il filtro si applica a livello di componente: un componente con stock anche presso un solo distributore è considerato disponibile.

supSearch(q: "LM339", limit: 10, inStockOnly: true) { ... }

Solo venditori autorizzati

Passa authorizedOnly: true nel campo sellers per restituire solo distributori autorizzati, escludendo broker e venditori del mercato grigio.

sellers(authorizedOnly: true) {
  company { name }
  offers { inventoryLevel }
}

Filtra per distributore

Usa options.filters.distributor_id per limitare i risultati a distributori specifici. Puoi passare sia l'ID numerico del distributore sia il suo nome:

query MultiMatch {
  supMultiMatch(
    queries: [{ mpn: "FH12-5S-1SH(55)", limit: 2 }]
    options: { filters: { distributor_id: ["Digi-Key", "Mouser"] } }
  ) {
    hits
    parts {
      mpn
      sellers {
        company { name }
        offers {
          prices { price currency }
        }
      }
    }
  }
}

L'elenco completo degli ID distributore è disponibile su octopart.com/api/v4/values.

Regione e valuta

Molti distributori forniscono livelli di inventario differenti a seconda del Paese dell'acquirente. L'API usa per impostazione predefinita US e USD se Paese e valuta non sono specificati.

Passa country e currency a livello di query per ottenere risultati appropriati per la regione:

query GBMatch {
  supMultiMatch(
    country: "GB"
    currency: "GBP"
    queries: [{ mpn: "LM358DR", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company { name }
        offers { inventoryLevel }
      }
    }
  }
}

I codici Paese seguono lo standard ISO 3166 alpha-2; i codici valuta seguono lo standard ISO 4217.

Tieni presente che molti distributori spediscono in più Paesi o non separano lo stock per Paese, quindi country e currency non sono un filtro rigido: influenzano quali offerte vengono mostrate e il relativo prezzo.

Caratteri jolly

Quando la corrispondenza su numeri di parte parziali restituisce troppi risultati, i caratteri jolly ti permettono di restringere la ricerca:

Per impostazione predefinita, i caratteri jolly iniziali e finali vengono aggiunti automaticamente – quindi 74LS25 e *74LS25* restituiscono gli stessi risultati.

Se aggiungi esplicitamente un qualsiasi carattere jolly, i caratteri jolly automatici not vengono aggiunti. Questo è utile per le ricerche per prefisso:

lv40    → matches anything containing "lv40" (wildcards added automatically)
lv40*   → matches only parts starting with "lv40"

MPN inattesi nei risultati

Quando usi la corrispondenza MPN, potresti occasionalmente ricevere componenti i cui MPN sembrano diversi da quello cercato. Si tratta di un comportamento previsto, dovuto al modo in cui il motore di ricerca tokenizza e indicizza i codici dei componenti.

I caratteri non alfanumerici (come - e .) vengono ignorati durante la creazione dell'indice di ricerca. La corrispondenza viene poi eseguita usando trigrammi (sequenze di tre caratteri). Ad esempio, cercando ASV-18432MHZ-EJ-T potresti ottenere anche ASV-18.432MHZ-EJ-T perché entrambi vengono tokenizzati nello stesso insieme di trigrammi.

If an exact character match is requiredPer evitare questo problema, confronta gli MPN restituiti con il tuo input e filtra i risultati nella tua applicazione.

Campi chiave della risposta