Query di esempio

Cambia la tua regione

Molti dei nostri partner distributori mostrano livelli di inventario diversi a seconda del paese dell’utente. Per impostazione predefinita, l’API usa US e USD come paese e valuta, ma questi valori possono essere sovrascritti per ottenere risultati più adatti alla tua area geografica.

Confronta la query per la Gran Bretagna:

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

... con la query negli Stati Uniti: 

query USMatch {
  supMultiMatch(
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

In questo caso, in quel determinato giorno, erano disponibili 1.370 componenti spedibili verso la GB. Tuttavia, negli Stati Uniti sarebbero stati visibili solo 300 componenti disponibili.

Molti distributori spediscono in più paesi o non separano lo stock in base al paese; pertanto, il paese e la valuta forniti in input non vengono usati come filtro rigido.

I codici paese seguono lo standard ISO 3166 (alpha-2); i codici valuta seguono lo standard ISO 4217. 

Corrispondenza esatta dell’mpn con fornitori specifici

Usando la SupMultiMatch query:

query MultiMatch {
  supMultiMatch(
    queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
    options: {filters: {distributor_id: ["459", "1106", "2401", "2628", "2454", "3261", "12947"]}}
  ) {
    hits
    parts {
      mpn
      name
      sellers {
        company {
          name
        }
        offers {
          prices {
            price
            currency
          }
        }
      }
    }
  }
}

Tieni presente che questo applicherà un filtro ai componenti venduti dai distributori specificati. L’elenco dei distributori è disponibile qui. Se anche altri distributori vendono questo componente, verranno comunque elencati. Se lo desideri, puoi sempre filtrarli durante l’elaborazione.

Invece dell’ID azienda, ad esempio "459", puoi specificare il nome dell’azienda, ad esempio "Digi-Key". Ecco un esempio:

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

Componenti di venditori con informazioni sui prezzi

Ecco una query di esempio che puoi usare nel tuo IDE:

query FindPrices {
  supSearch(q: "AEC-Q100", limit: 3) { 
    results {
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices{
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

Corrispondenza esatta del componente

La query supMultiMatch consente di inserire più MPN per recuperare i dati e cerca una corrispondenza esatta per ciascuno.

query MatchParts {
  supMultiMatch(queries: [{mpn: "G3VM-101PR"}]) {
    hits
    reference
    parts {
      id
      slug
      mpn
      manufacturer {
        name
      }
    }
  }
}

Filtro per componenti in stock

Durante la ricerca puoi specificare di includere solo i componenti disponibili a magazzino. Per esempio:

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

Impostando questo filtro su true vengono esclusi i componenti che hanno no stock at all. Se un componente ha inventario presso anche un solo distributore, viene considerato in stock e restituito come parte della query.

Questo filtro non prende affatto in considerazione lo stock del distributore: si applica a livello di componente.

Ecco un esempio che puoi provare. Questa query cerca AEC-Q100 con una paginazione start pagina di 5, e inStockOnly impostato su true:

query in_stock_filter{
  supSearch(q: "AEC-Q100", start: 5, inStockOnly: true) { 
    results {
      
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
        }
      }
    }
  }
}

Restituzione di MPN imprevisti

Durante la ricerca o il matching, talvolta vengono trovati componenti aggiuntivi in cui gli MPN differiscono solo per caratteri non alfanumerici, come - o ..

Ad esempio, considera una query supMultiMatch per il seguente MPN:

query MultiMatch {
  supMultiMatch(queries: {mpn: "ASV-18432MHZ-EJ-T", limit: 5}) {
    hits
    parts {
      mpn
    }
  }
}

Questa potrebbe restituire più MPN, come ASV-18.432MHZ-EJ-T così come ASV-1.8432MHZ-E-J-T (e altri).

Questo comportamento è dovuto al modo in cui i componenti vengono "tokenizzati" per l’indicizzazione nel motore di ricerca elastic.

Gli MPN vengono suddivisi in token ignorando i caratteri speciali (ad esempio, CV 3-200/SPG potrebbe diventare `CV`, `3200`, `SPG`).

La corrispondenza viene quindi effettuata usando trigrammi (combinazioni di tre lettere). La ricerca deve corrispondere completamente a un MPN tokenizzato, ma le corrispondenze parziali dipendono dai trigrammi. Per esempio:

• Match: "CV 3-20", "CV 320", "00 SPG" - Each part aligns with at least one full token

• No Match: "CV 3", "CV 3-", "CV 32" - No part of these aligns with any token

Uso dei caratteri jolly

Talvolta, la ricerca tramite numero di parte parziale restituisce troppi componenti, oppure hai requisiti specifici per la corrispondenza del numero di parte. In questi casi, puoi usare i caratteri jolly per affinare la ricerca.

• Il carattere * corrisponde a qualsiasi sequenza di caratteri (inclusa una sequenza vuota).

• Il carattere ? corrisponde a un singolo carattere qualsiasi.

I caratteri jolly possono essere usati in qualsiasi punto del numero di parte. Usare caratteri jolly per trovare la parte centrale di un numero di parte non è necessario: i caratteri jolly iniziali e finali vengono aggiunti automaticamente. Per esempio, *74LS25* restituisce gli stessi risultati di 74LS25.

Se aggiungi uno o più caratteri jolly a un termine, non vengono aggiunti automaticamente altri caratteri jolly. Questo può essere usato per eseguire ricerche per prefisso. Per esempio, lv40 trova i componenti che contengono lv40 in qualsiasi punto del numero di parte, mentre lv40* trova solo i componenti che iniziano con lv40.

Lead time di fabbrica per i componenti

Nell’API sono disponibili due campi interrogabili.

1. factoryLeadDays su SupOffer restituisce il numero di giorni necessari per approvvigionare i componenti dalla fabbrica.

2. estimatedFactoryLeadDays su SupPart restituisce il lead time di fabbrica stimato in giorni, derivato da offerte di distributori affidabili.

Ecco una query di esempio per i venditori autorizzati:

query LeadDaysSearch {
  supSearch(q: "IRL3803STRLPBF", limit: 2) {
    results {
      part {
        mpn
        estimatedFactoryLeadDays
        sellers(authorizedOnly: true) {
          offers {
            factoryLeadDays
          }
        }
      }
    }
  }
}

Componenti simili

Durante la ricerca o il matching dei componenti, puoi specificare di restituire similarParts. Si tratta di componenti identificati da Nexar come simili per specifiche e funzionalità. Ecco una query di esempio:

query SimilarParts {
  supSearch(q: "LM339MX", limit: 1) {
    hits
    results {
      part {
        id
        mpn
        name
        manufacturer { name }
        similarParts {
          id
          mpn
          manufacturer { name }
        }
      }
    }
  }
}