Recherche

L’API Octopart propose trois requêtes pour trouver des composants. Le choix de la bonne dépend de ce que vous savez sur le composant que vous recherchez.

Correspondance MPN

supMultiMatch – Batch Exact Match

supMultiMatch accepte une liste de MPN ou de SKU et renvoie la meilleure correspondance pour chacun. C’est le bon choix lorsque vous connaissez les références et devez rechercher plusieurs composants dans une seule requête.

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

Chaque élément dans queries peut inclure son propre limit pour contrôler le nombre de composants correspondants renvoyés pour ce MPN.

supSearchMpn – Recherche d’un MPN unique

supSearchMpn prend une seule chaîne de requête et renvoie des résultats classés par correspondance MPN. Utilisez-la lorsque vous recherchez un composant à la fois.

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

Recherche par mot-clé

supSearch effectue une recherche plus large dans les descriptions, spécifications et catégories des composants. Utilisez-la lorsque vous n’avez pas de MPN exact – par exemple, lors d’une recherche par type de composant et caractéristiques électriques.

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 chaîne q est comparée aux descriptions, catégories et attributs indexés des composants. Pour le filtrage basé sur les attributs (par ex. capacité exacte ou tension nominale), utilisez le paramètre filters – voir les attributs de filtre disponibles.

Filtrage des résultats

Filtre en stock

Passez inStockOnly: true pour exclure les composants qui n’ont aucun stock chez aucun distributeur. Le filtre s’applique au niveau du composant – un composant avec du stock chez un seul distributeur est considéré comme en stock.

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

Vendeurs autorisés uniquement

Passez authorizedOnly: true sur le champ sellers pour ne renvoyer que les distributeurs autorisés, en excluant les courtiers et vendeurs du marché gris.

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

Filtrer par distributeur

Utilisez options.filters.distributor_id pour limiter les résultats à des distributeurs spécifiques. Vous pouvez fournir soit l’identifiant numérique du distributeur, soit son nom :

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 }
        }
      }
    }
  }
}

La liste complète des identifiants de distributeurs est disponible sur octopart.com/api/v4/values.

Région et devise

De nombreux distributeurs proposent des niveaux de stock différents selon le pays de l’acheteur. Par défaut, l’API utilise US et USD si le pays et la devise ne sont pas spécifiés.

Passez country et currency au niveau de la requête pour obtenir des résultats adaptés à la région :

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

Les codes pays suivent la norme ISO 3166 alpha-2 ; les codes devise suivent la norme ISO 4217.

Notez que de nombreux distributeurs livrent dans plusieurs pays ou ne segmentent pas leur stock par pays ; country et currency ne sont donc pas un filtre strict – ils influencent les offres mises en avant ainsi que leur tarification.

Caractères génériques

Lorsque la correspondance sur une référence partielle renvoie trop de résultats, les caractères génériques permettent d’affiner la recherche :

Par défaut, des caractères génériques de début et de fin sont ajoutés automatiquement – ainsi, 74LS25 et *74LS25* renvoient les mêmes résultats.

Si vous ajoutez explicitement un caractère générique, les caractères génériques automatiques ne sont not pas ajoutés. Cela est utile pour les recherches par préfixe :

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

MPN inattendus dans les résultats

Lors de l’utilisation de la correspondance MPN, il se peut que vous receviez occasionnellement des composants dont les MPN semblent différents de celui recherché. Il s’agit d’un comportement normal dû à la manière dont le moteur de recherche segmente et indexe les références.

Les caractères non alphanumériques (tels que - et .) sont ignorés lors de la construction de l’index de recherche. La correspondance est ensuite effectuée à l’aide de trigrammes (séquences de trois caractères). Par exemple, une recherche sur ASV-18432MHZ-EJ-T peut aussi renvoyer ASV-18.432MHZ-EJ-T car les deux sont segmentés en le même ensemble de trigrammes.

If an exact character match is requiredPour éviter cela, comparez les MPN renvoyés à votre saisie et filtrez les résultats dans votre application.

Champs clés de la réponse