Buscar

La API de Octopart ofrece tres consultas para encontrar piezas. Elegir la adecuada depende de lo que sepas sobre la pieza que buscas.

Coincidencia de MPN

supMultiMatch – Batch Exact Match

supMultiMatch acepta una lista de MPN o SKU y devuelve la mejor coincidencia para cada uno. Es la opción correcta cuando conoces los números de pieza y necesitas consultar varias piezas en una sola solicitud.

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

Cada elemento en queries puede incluir su propio limit para controlar cuántas piezas coincidentes se devuelven para ese MPN.

supSearchMpn – Búsqueda de un solo MPN

supSearchMpn toma una sola cadena de consulta y devuelve resultados clasificados por coincidencia de MPN. Úsala cuando busques una sola pieza a la vez.

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

Búsqueda por palabra clave

supSearch realiza una búsqueda más amplia en descripciones de piezas, especificaciones y categorías. Úsala cuando no tengas un MPN exacto, por ejemplo, al buscar por tipo de componente y características eléctricas.

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 cadena q se compara con descripciones de piezas, categorías y atributos indexados. Para el filtrado basado en atributos (p. ej., capacitancia exacta o tensión nominal), usa el parámetro filters; consulta atributos de filtro disponibles.

Filtrado de resultados

Filtro de disponibilidad en stock

Pasa inStockOnly: true para excluir piezas que no tengan stock en ningún distribuidor. El filtro se aplica a nivel de pieza: una pieza con stock en aunque sea un distribuidor se considera en stock.

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

Solo vendedores autorizados

Pasa authorizedOnly: true en el campo sellers para devolver solo distribuidores autorizados, excluyendo brokers y vendedores del mercado gris.

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

Filtrar por distribuidor

Usa options.filters.distributor_id para limitar los resultados a distribuidores específicos. Puedes pasar el ID numérico del distribuidor o su nombre:

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 lista completa de IDs de distribuidores está disponible en octopart.com/api/v4/values.

Región y moneda

Muchos distribuidores proporcionan diferentes niveles de inventario según el país del comprador. La API usa por defecto US y USD si no se especifican país ni moneda.

Pasa country y currency a nivel de consulta para obtener resultados apropiados para la región:

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

Los códigos de país siguen ISO 3166 alpha-2; los códigos de moneda siguen ISO 4217.

Ten en cuenta que muchos distribuidores envían a varios países o no segregan el stock por país, por lo que country y currency no son un filtro estricto: influyen en qué ofertas se muestran y en sus precios.

Comodines

Cuando la coincidencia por número de pieza parcial devuelve demasiados resultados, los comodines te permiten acotar la búsqueda:

De forma predeterminada, se agregan automáticamente comodines al principio y al final; por lo tanto, 74LS25 y *74LS25* devuelven los mismos resultados.

Si agregas explícitamente cualquier comodín, los comodines automáticos not se agregan. Esto resulta útil para búsquedas por prefijo:

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

MPN inesperados en los resultados

Al usar coincidencia de MPN, es posible que ocasionalmente recibas piezas cuyos MPN parezcan distintos del que buscaste. Este es un comportamiento esperado debido a cómo el motor de búsqueda tokeniza e indexa los números de pieza.

Los caracteres no alfanuméricos (como - y .) se ignoran al construir el índice de búsqueda. Luego, la coincidencia se realiza usando trigramas (secuencias de tres caracteres). Por ejemplo, buscar ASV-18432MHZ-EJ-T también puede devolver ASV-18.432MHZ-EJ-T porque ambos se tokenizan en el mismo conjunto de trigramas.

If an exact character match is requiredPara evitarlo, compara los MPN devueltos con tu entrada y filtra los resultados en tu aplicación.

Campos clave de la respuesta