Pesquisar

A API do Octopart oferece três consultas para localizar peças. A escolha da consulta correta depende do que você sabe sobre a peça que está procurando.

Correspondência de MPN

supMultiMatch – Batch Exact Match

supMultiMatch aceita uma lista de MPNs ou SKUs e retorna a melhor correspondência para cada um. É a escolha certa quando você conhece os números das peças e precisa consultar várias peças em uma única solicitação.

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

Cada elemento em queries pode incluir seu próprio limit para controlar quantas peças correspondentes são retornadas para aquele MPN.

supSearchMpn – Pesquisa de MPN Único

supSearchMpn recebe uma única string de consulta e retorna resultados ranqueados de correspondência de MPN. Use-a ao pesquisar uma peça por vez.

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

Pesquisa por Palavra-chave

supSearch realiza uma busca mais ampla em descrições de peças, especificações e categorias. Use-a quando você não tiver um MPN exato – por exemplo, ao pesquisar por tipo de componente e características elétricas.

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

A string q é comparada com descrições de peças, categorias e atributos indexados. Para filtragem baseada em atributos (por exemplo, capacitância exata ou tensão nominal), use o parâmetro filters – consulte atributos de filtro disponíveis.

Filtragem de Resultados

Filtro de Itens em Estoque

Passe inStockOnly: true para excluir peças que não tenham estoque em nenhum distribuidor. O filtro se aplica no nível da peça – uma peça com estoque em apenas um distribuidor já é considerada em estoque.

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

Apenas Vendedores Autorizados

Passe authorizedOnly: true no campo sellers para retornar apenas distribuidores autorizados, excluindo corretores e vendedores do mercado cinza.

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

Filtrar por Distribuidor

Use options.filters.distributor_id para limitar os resultados a distribuidores específicos. Você pode passar o ID numérico do distribuidor ou o nome dele:

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

A lista completa de IDs de distribuidores está disponível em octopart.com/api/v4/values.

Região e Moeda

Muitos distribuidores fornecem níveis de estoque diferentes dependendo do país do comprador. A API usa por padrão US e USD se país e moeda não forem especificados.

Passe country e currency no nível da consulta para obter resultados adequados à região:

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

Os códigos de país seguem a ISO 3166 alpha-2; os códigos de moeda seguem a ISO 4217.

Observe que muitos distribuidores enviam para vários países ou não segregam o estoque por país, portanto country e currency não são um filtro rígido – eles influenciam quais ofertas são exibidas e seus preços.

Curingas

Quando a correspondência de número de peça parcial retorna muitos resultados, os curingas permitem refinar a pesquisa:

Por padrão, curingas no início e no fim são adicionados automaticamente – portanto 74LS25 e *74LS25* retornam os mesmos resultados.

Se você adicionar qualquer curinga explicitamente, curingas automáticos not serão adicionados. Isso é útil para pesquisas por prefixo:

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

MPNs Inesperados nos Resultados

Ao usar correspondência de MPN, você pode ocasionalmente receber peças cujos MPNs parecem diferentes daquele que você pesquisou. Esse é um comportamento esperado, causado pela forma como o mecanismo de busca tokeniza e indexa os números de peça.

Caracteres não alfanuméricos (como - e .) são ignorados ao construir o índice de busca. A correspondência é então feita usando trigramas (sequências de três caracteres). Por exemplo, pesquisar por ASV-18432MHZ-EJ-T também pode retornar ASV-18.432MHZ-EJ-T porque ambos são tokenizados no mesmo conjunto de trigramas.

If an exact character match is requiredPara evitar isso, compare os MPNs retornados com sua entrada e filtre os resultados na sua aplicação.

Principais Campos da Resposta