Примеры запросов

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

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

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

Если требуется точное посимвольное совпадение, клиентское приложение должно сравнить полученные MPN с исходным значением и отфильтровать результаты после получения ответа.

Использование подстановочных символов

Иногда поиск по части номера компонента возвращает слишком много компонентов либо у вас есть особые требования к сопоставлению номеров компонентов. В таких случаях можно уточнить поиск с помощью подстановочных символов.

  • Символ * соответствует любой последовательности символов (в том числе пустой).

  • Символ ? соответствует любому одному символу.

Подстановочные символы можно использовать в любом месте номера компонента. Для поиска по средней части номера компонента указывать их не требуется — подстановочные символы автоматически добавляются в начало и конец. Например, *74LS25* возвращает те же результаты, что и 74LS25.

Если вы добавите в поисковое выражение один или несколько подстановочных символов, другие подстановочные символы автоматически добавляться не будут. Это можно использовать для поиска по началу номера. Например, lv40 находит компоненты, у которых lv40 встречается в любом месте номера, тогда как lv40* находит только компоненты, номера которых начинаются с lv40.

Обратите внимание: поиск по lv40* вернет такие компоненты, как lv-4000, из-за особенностей обработки поисковой системой некоторых символов, не являющихся буквами или цифрами, например - или ..

Срок поставки компонентов с завода

В API можно запрашивать два поля.

  1. factoryLeadDays в SupOffer возвращает количество дней, необходимых для получения компонентов с завода.

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

 

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