Примеры запросов
Краткий обзор
- Узнайте, как задать страну и валюту, отфильтровать компоненты, предлагаемые определенными поставщиками, и запросить цены и данные о наличии.
- Разберитесь в фильтрации по наличию на уровне компонента, особенностях поиска по MPN и использовании подстановочных знаков, чтобы точнее интерпретировать и уточнять результаты.
- Посмотрите, как получить сроки поставки с завода и найти компоненты, определенные как аналогичные по характеристикам и функциональности.
Изменение региона
У многих наших партнеров-дистрибьюторов доступные складские запасы зависят от страны пользователя. По умолчанию в API используются страна US и валюта USD, но эти значения можно переопределить, чтобы получить результаты, более подходящие для вашего региона.
Сравните запрос для Великобритании:
query GBMatch {
supMultiMatch(
country: "GB"
currency: "GBP"
queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
) {
parts {
sellers(authorizedOnly: true) {
company {
name
}
offers {
inventoryLevel
}
}
}
}
}
... с запросом для США:
query USMatch {
supMultiMatch(
queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
) {
parts {
sellers(authorizedOnly: true) {
company {
name
}
offers {
inventoryLevel
}
}
}
}
}
В данном случае на момент запроса для доставки в Великобританию было доступно 1370 компонентов. Однако пользователи из США увидели бы только 300 доступных компонентов.
Многие дистрибьюторы поставляют компоненты в несколько стран или не разделяют складские запасы по странам, поэтому указанные страна и валюта не используются в качестве строгого фильтра.
Коды стран соответствуют стандарту ISO 3166 (alpha-2), а коды валют — стандарту ISO 4217.
Точное совпадение MPN с указанием поставщиков
С помощью запроса SupMultiMatch:
query MultiMatch {
supMultiMatch(
queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
options: {filters: {distributor_id: ["459", "1106", "2401", "2628", "2454", "3261", "12947"]}}
) {
hits
parts {
mpn
name
sellers {
company {
name
}
offers {
prices {
price
currency
}
}
}
}
}
}
Обратите внимание: этот запрос отбирает компоненты, продаваемые указанными дистрибьюторами. Список дистрибьюторов доступен здесь. Если этот компонент продают и другие дистрибьюторы, они также будут указаны. При необходимости их можно отфильтровать при обработке результатов.
Вместо идентификатора компании, например "459", можно указать ее название, например "Digi-Key". Вот пример:
query MultiMatch {
supMultiMatch(
queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
options: {filters: {distributor_id: ["Digi-Key"]}}
) {
hits
parts {
mpn
name
sellers {
company {
name
}
offers {
prices {
price
currency
}
}
}
}
}
}
Компоненты от продавцов с информацией о ценах
Вот пример запроса, который можно использовать в вашей IDE:
query FindPrices {
supSearch(q: "AEC-Q100", limit: 3) {
results {
part {
mpn
manufacturer {
name
}
sellers(includeBrokers: false) {
company {
name
}
offers {
clickUrl
inventoryLevel
prices{
price
currency
quantity
}
}
}
}
}
}
}
Точное совпадение компонента
Запрос supMultiMatch позволяет указать несколько MPN для получения данных и ищет точное совпадение для каждого из них.
query MatchParts {
supMultiMatch(queries: [{mpn: "G3VM-101PR"}]) {
hits
reference
parts {
id
slug
mpn
manufacturer {
name
}
}
}
}
Фильтрация компонентов по наличию
При поиске можно указать, что в результаты должны включаться только компоненты, имеющиеся в наличии. Например:
supSearch(q: "LM339", limit: 1, inStockOnly: true) { ... }
Если установить для этого фильтра значение true, компоненты с no stock at all будут исключены. Если компонент есть на складе хотя бы у одного дистрибьютора, он считается имеющимся в наличии и включается в результаты запроса.
Эта фильтрация не учитывает складские запасы отдельных дистрибьюторов — она применяется на уровне компонента.
Вот пример, который вы можете попробовать. Этот запрос ищет AEC-Q100 с параметром постраничной выдачи start, равным 5, и параметром inStockOnly, установленным в true:
query in_stock_filter{
supSearch(q: "AEC-Q100", start: 5, inStockOnly: true) {
results {
part {
mpn
manufacturer {
name
}
sellers(includeBrokers: false) {
company {
name
}
}
}
}
}
}
Неожиданные MPN в результатах
При поиске или подборе соответствий иногда находятся дополнительные компоненты, у которых MPN отличаются только символами, не являющимися буквами или цифрами, например - или ..
Для примера рассмотрим запрос supMultiMatch для следующего MPN:
query MultiMatch {
supMultiMatch(queries: {mpn: "ASV-18432MHZ-EJ-T", limit: 5}) {
hits
parts {
mpn
}
}
}
Он может вернуть несколько MPN, например ASV-18.432MHZ-EJ-T, а также ASV-1.8432MHZ-E-J-T (и другие).
Такое поведение связано с тем, как обозначения компонентов разбиваются на токены для индексации в поисковой системе Elasticsearch.
MPN разбиваются на токены, при этом специальные символы игнорируются (например, CV 3-200/SPG может превратиться в `CV`, `3200`, `SPG`).
Затем сопоставление выполняется с помощью триграмм (комбинаций из трех букв). Поисковый запрос должен полностью совпадать с MPN, разбитым на токены, но частичные совпадения зависят от триграмм. Например:
-
Match: "CV 3-20", "CV 320", "00 SPG" - Each part aligns with at least one full token
-
No Match: "CV 3", "CV 3-", "CV 32" - No part of these aligns with any token
Использование подстановочных символов
Иногда поиск по части номера компонента возвращает слишком много компонентов либо у вас есть особые требования к сопоставлению номеров компонентов. В таких случаях можно уточнить поиск с помощью подстановочных символов.
-
Символ
*соответствует любой последовательности символов (в том числе пустой). -
Символ
?соответствует любому одному символу.
Подстановочные символы можно использовать в любом месте номера компонента. Для поиска по средней части номера компонента указывать их не требуется — подстановочные символы автоматически добавляются в начало и конец. Например, *74LS25* возвращает те же результаты, что и 74LS25.
Если вы добавите в поисковое выражение один или несколько подстановочных символов, другие подстановочные символы автоматически добавляться не будут. Это можно использовать для поиска по началу номера. Например, lv40 находит компоненты, у которых lv40 встречается в любом месте номера, тогда как lv40* находит только компоненты, номера которых начинаются с lv40.
Срок поставки компонентов с завода
В API можно запрашивать два поля.
-
factoryLeadDaysвSupOfferвозвращает количество дней, необходимых для получения компонентов с завода. -
estimatedFactoryLeadDaysвSupPartвозвращает расчетный срок поставки с завода в днях, определенный по предложениям проверенных дистрибьюторов.
Вот пример запроса для авторизованных продавцов:
query LeadDaysSearch {
supSearch(q: "IRL3803STRLPBF", limit: 2) {
results {
part {
mpn
estimatedFactoryLeadDays
sellers(authorizedOnly: true) {
offers {
factoryLeadDays
}
}
}
}
}
}
Аналогичные компоненты
При поиске или подборе компонентов можно указать, что нужно возвращать similarParts. Это компоненты, которые Nexar определяет как схожие по характеристикам и функциональности. Вот пример запроса:
query SimilarParts {
supSearch(q: "LM339MX", limit: 1) {
hits
results {
part {
id
mpn
name
manufacturer { name }
similarParts {
id
mpn
manufacturer { name }
}
}
}
}
}