Инструмент поиска компонентов на складах
Краткий обзор
- Узнайте, как установить компонент и добавить интерфейс поиска по номерам деталей производителя.
- Посмотрите, как заранее выбрать конкретный компонент и скрыть строку поиска на страницах с подробной информацией о товаре.
- Разберитесь со сроком действия токенов и работой с ними в рабочей среде, а также найдите справочные материалы по фильтрам, оформлению и столбцам таблицы предложений.
Stock Locator Tool — это React-компонент, который с помощью Octopart API отображает актуальные цены и доступность по заданному номеру детали производителя: складские остатки, цены в зависимости от объема заказа и ссылки на дистрибьюторов. Его можно встроить в страницы товаров, инструменты закупок или любое React-приложение.
Предварительные требования
-
Проект на React
-
Токен доступа OAuth 2.0 с областью доступа
supply.domain— тот же токен, который используется для прямых запросов к API (см. Авторизация)
Установка
npm i @altiumnexar/stock-locator-tool
Базовое использование
import { StockLocatorTool } from "@altiumnexar/stock-locator-tool";
function MyPage() {
return (
<StockLocatorTool
searchParameters={{ token: "YOUR_ACCESS_TOKEN" }}
/>
);
}
При этом отображается полноценный интерфейс поиска, в котором пользователи могут ввести любой номер детали производителя (MPN), чтобы увидеть актуальные предложения и складские остатки.
Режим одного компонента
Чтобы заранее выбрать компонент и скрыть строку поиска (например, на странице товара):
<StockLocatorTool
searchParameters={{
token: "YOUR_ACCESS_TOKEN",
q: "LM358DR",
disableSearch: true,
}}
/>
Работа с токенами
Срок действия токенов доступа — 24 часа. Во время разработки токен можно временно прописать непосредственно в коде. В рабочей среде получайте токен с вашего бэкенда с помощью типа предоставления доступа client_credentials и обновляйте его до истечения срока действия. Никогда не раскрывайте Client Secret в клиентском коде.
Дополнительная информация
В репозитории GitHub описаны все доступные свойства компонента:
-
searchParameters— регион, валюта, фильтры авторизованных дистрибьюторов и наличия на складе, видимость строки поиска, ограничение числа предложений и многое другое -
styles— светлая/темная тема, шрифт и полный справочник токенов пользовательских цветов -
hideColumns— управление набором столбцов в таблице предложений