Поиск

Краткий обзор

Поиск компонентов с помощью Octopart API начинается с выбора подходящего запроса в зависимости от имеющихся данных: известных артикулов производителя (MPN) и складских артикулов (SKU), ключевых слов или частичных обозначений компонентов. В этой статье рассматриваются примеры запросов, параметры фильтрации, настройки региона и валюты, а также особенности поиска, которые могут повлиять на результаты. Читайте дальше, чтобы уверенно выбрать подходящий способ поиска.

- Узнайте, когда использовать 'supMultiMatch', 'supSearchMpn' и 'supSearch'.
- Разберитесь, как фильтры по наличию, продавцам и дистрибьюторам, а также региональные настройки влияют на компоненты и предложения в результатах поиска.
- Изучите поиск с подстановочными знаками, причины появления неожиданных MPN в результатах и ключевые поля ответа для интерпретации данных о компонентах.
Узнайте больше с ИИ:

API Octopart предоставляет три запроса для поиска компонентов. Выбор подходящего запроса зависит от того, что вам известно об искомом компоненте.

Запрос

Когда использовать...

supMultiMatch

У вас есть один или несколько точных номеров MPN или SKU, и вам нужно точное соответствие для каждого

supSearchMpn

У вас есть один MPN, и вам нужны результаты, ранжированные по степени соответствия MPN

supSearch

Вы ищете по ключевому слову, описанию или части номера компонента

Сопоставление по 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.

Note: Этот фильтр определяет, предложения каких дистрибьюторов будут показаны в ответе, но не исключает компоненты, продаваемые другими дистрибьюторами. Если в результатах нужны только указанные дистрибьюторы, отфильтруйте массив продавцов в своём приложении.

Регион и валюта

У многих дистрибьюторов данные об остатках зависят от страны покупателя. Если страна и валюта не указаны, 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"

Note: Поскольку поисковая система нормализует символы, не являющиеся буквами или цифрами, такие как - и ., поиск по lv40* также может возвращать компоненты вида lv-4000.

Неожиданные MPN в результатах

При сопоставлении по MPN иногда могут возвращаться компоненты, номера MPN которых выглядят иначе, чем указанный в запросе. Это ожидаемое поведение, связанное с тем, как поисковая система разбивает номера компонентов на токены и индексирует их.

При построении поискового индекса символы, не являющиеся буквами или цифрами (например, - и .), игнорируются. Затем сопоставление выполняется по триграммам — последовательностям из трёх символов. Например, поиск по ASV-18432MHZ-EJ-T может также вернуть ASV-18.432MHZ-EJ-T, поскольку оба номера разбиваются на одинаковый набор триграмм.

If an exact character match is required, сравнивайте возвращаемые MPN с исходным значением и фильтруйте результаты в своём приложении.

Основные поля ответа

Поле

Расположение

Описание

mpn

part

Номер компонента по каталогу производителя

manufacturer.name

part

Название производителя

sellers

part

Список продавцов с предложениями

company.name

sellers

Название дистрибьютора или брокера

inventoryLevel

offers

Количество на складе (специальные коды см. в разделе «Складские запасы»)

prices

offers

Ценовые ступени в зависимости от количества с price, currency и quantity

clickUrl

offers

Прямая ссылка на предложение на сайте дистрибьютора

factoryLeadDays

offers

Срок получения с завода в днях для каждого предложения дистрибьютора

estimatedFactoryLeadDays

part

Ориентировочный срок поставки с завода, рассчитанный на основе предложений надёжных дистрибьюторов

similarParts

part

Функционально эквивалентные компоненты-аналоги

 

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Contents
Contents