Поиск
Краткий обзор
- Узнайте, когда использовать 'supMultiMatch', 'supSearchMpn' и 'supSearch'.
- Разберитесь, как фильтры по наличию, продавцам и дистрибьюторам, а также региональные настройки влияют на компоненты и предложения в результатах поиска.
- Изучите поиск с подстановочными знаками, причины появления неожиданных MPN в результатах и ключевые поля ответа для интерпретации данных о компонентах.
API Octopart предоставляет три запроса для поиска компонентов. Выбор подходящего запроса зависит от того, что вам известно об искомом компоненте.
Запрос |
Когда использовать... |
|
У вас есть один или несколько точных номеров MPN или SKU, и вам нужно точное соответствие для каждого |
|
У вас есть один MPN, и вам нужны результаты, ранжированные по степени соответствия MPN |
|
Вы ищете по ключевому слову, описанию или части номера компонента |
Сопоставление по MPN
supMultiMatch – Batch Exact Match
supMultiMatch принимает список номеров MPN или SKU и возвращает наилучшее соответствие для каждого. Этот вариант подходит, если вы знаете номера компонентов и хотите найти несколько компонентов одним запросом.
query MatchParts {
supMultiMatch(queries: [{ mpn: "LM358DR" }, { mpn: "LM339MX" }]) {
hits
parts {
mpn
manufacturer {
name
}
sellers {
company {
name
}
offers {
inventoryLevel
prices {
price
currency
quantity
}
}
}
}
}
}
Каждый элемент в queries может содержать собственный limit, определяющий, сколько найденных компонентов возвращать для данного MPN.
supSearchMpn – Поиск по одному MPN
supSearchMpn принимает одну строку запроса и возвращает результаты, ранжированные по степени соответствия MPN. Используйте этот вариант для поиска одного компонента за раз.
query FindByMpn {
supSearchMpn(q: "LM358", limit: 5) {
hits
results {
part {
mpn
manufacturer {
name
}
}
}
}
}
Поиск по ключевым словам
supSearch выполняет более широкий поиск по описаниям, характеристикам и категориям компонентов. Используйте его, если у вас нет точного MPN, например при поиске по типу компонента и электрическим характеристикам.
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
}
}
}
}
}
}
}
Строка q сопоставляется с описаниями, категориями и индексируемыми атрибутами компонентов. Для фильтрации по атрибутам (например, по точному значению ёмкости или номинального напряжения) используйте параметр filters — см. доступные атрибуты фильтрации.
Фильтрация результатов
Фильтр наличия
Передайте inStockOnly: true, чтобы исключить компоненты, которых нет в наличии ни у одного дистрибьютора. Фильтр применяется на уровне компонента: компонент считается доступным, если он есть в наличии хотя бы у одного дистрибьютора.
supSearch(q: "LM339", limit: 10, inStockOnly: true) { ... }
Только авторизованные продавцы
Передайте authorizedOnly: true в поле sellers, чтобы получать только авторизованных дистрибьюторов, исключая брокеров и продавцов серого рынка.
sellers(authorizedOnly: true) {
company { name }
offers { inventoryLevel }
}
Фильтрация по дистрибьютору
Используйте options.filters.distributor_id, чтобы ограничить результаты определёнными дистрибьюторами. Можно передать числовой идентификатор дистрибьютора или его название:
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 }
}
}
}
}
}
Полный список идентификаторов дистрибьюторов доступен по адресу octopart.com/api/v4/values.
Регион и валюта
У многих дистрибьюторов данные об остатках зависят от страны покупателя. Если страна и валюта не указаны, API по умолчанию использует US и USD.
Передайте country и currency на уровне запроса, чтобы получить результаты с учётом региона:
query GBMatch {
supMultiMatch(
country: "GB"
currency: "GBP"
queries: [{ mpn: "LM358DR", limit: 3 }]
) {
parts {
sellers(authorizedOnly: true) {
company { name }
offers { inventoryLevel }
}
}
}
}
Коды стран соответствуют стандарту ISO 3166 alpha-2, а коды валют — ISO 4217.
Обратите внимание: многие дистрибьюторы поставляют товары в несколько стран или не разделяют складские запасы по странам, поэтому country и currency не задают строгую фильтрацию, а влияют на выбор отображаемых предложений и их цены.
Подстановочные знаки
Если поиск по части номера компонента возвращает слишком много результатов, подстановочные знаки позволяют сузить поиск:
Подстановочный знак |
Соответствует |
|
Любой последовательности символов (включая пустую) |
|
Любому одному символу |
По умолчанию подстановочные знаки автоматически добавляются в начало и конец строки, поэтому 74LS25 и *74LS25* возвращают одинаковые результаты.
Если вы явно укажете любой подстановочный знак, автоматические подстановочные знаки not добавляются. Это удобно для поиска по префиксу:
lv40 → matches anything containing "lv40" (wildcards added automatically)
lv40* → matches only parts starting with "lv40"
Неожиданные MPN в результатах
При сопоставлении по MPN иногда могут возвращаться компоненты, номера MPN которых выглядят иначе, чем указанный в запросе. Это ожидаемое поведение, связанное с тем, как поисковая система разбивает номера компонентов на токены и индексирует их.
При построении поискового индекса символы, не являющиеся буквами или цифрами (например, - и .), игнорируются. Затем сопоставление выполняется по триграммам — последовательностям из трёх символов. Например, поиск по ASV-18432MHZ-EJ-T может также вернуть ASV-18.432MHZ-EJ-T, поскольку оба номера разбиваются на одинаковый набор триграмм.
If an exact character match is required, сравнивайте возвращаемые MPN с исходным значением и фильтруйте результаты в своём приложении.
Основные поля ответа
Поле |
Расположение |
Описание |
|
|
Номер компонента по каталогу производителя |
|
|
Название производителя |
|
|
Список продавцов с предложениями |
|
|
Название дистрибьютора или брокера |
|
|
Количество на складе (специальные коды см. в разделе «Складские запасы») |
|
|
Ценовые ступени в зависимости от количества с |
|
|
Прямая ссылка на предложение на сайте дистрибьютора |
|
|
Срок получения с завода в днях для каждого предложения дистрибьютора |
|
|
Ориентировочный срок поставки с завода, рассчитанный на основе предложений надёжных дистрибьюторов |
|
|
Функционально эквивалентные компоненты-аналоги |