Công cụ Định vị Tồn kho

Stock Locator Tool là một thành phần React hiển thị giá và tình trạng sẵn có theo thời gian thực cho một mã linh kiện của nhà sản xuất nhất định – mức tồn kho, các mốc giá, và liên kết đến nhà phân phối – được cung cấp bởi Octopart API. Hãy nhúng nó vào các trang sản phẩm, công cụ mua sắm, hoặc bất kỳ ứng dụng React nào.

Điều kiện tiên quyết

• Một dự án React

• Một mã truy cập OAuth 2.0 với phạm vi supply.domain – cùng mã được dùng cho các truy vấn API trực tiếp (xem Authorization)

Cài đặt

npm i @altiumnexar/stock-locator-tool

Cách dùng cơ bản

import { StockLocatorTool } from "@altiumnexar/stock-locator-tool";

function MyPage() {
  return (
    <StockLocatorTool
      searchParameters={{ token: "YOUR_ACCESS_TOKEN" }}
    />
  );
}

Phần này sẽ hiển thị một giao diện tìm kiếm đầy đủ, nơi người dùng có thể nhập bất kỳ MPN nào để xem các chào bán trực tiếp và tồn kho.

Chế độ linh kiện đơn

Để điền sẵn một linh kiện và ẩn thanh tìm kiếm – hữu ích trên trang chi tiết sản phẩm:

<StockLocatorTool
  searchParameters={{
    token: "YOUR_ACCESS_TOKEN",
    q: "LM358DR",
    disableSearch: true,
  }}
/>

Xử lý mã truy cập

Mã truy cập sẽ hết hạn sau 24 giờ. Trong quá trình phát triển, bạn có thể tạm thời hardcode một mã. Trong môi trường production, hãy lấy mã từ backend của bạn thông qua quyền cấp client_credentials và làm mới mã trước khi hết hạn. Tuyệt đối không để lộ Client Secret trong mã phía client.

Tham khảo thêm

Kho lưu trữ GitHub ghi lại tài liệu cho tất cả các thuộc tính khả dụng:

• searchParameters – khu vực, tiền tệ, bộ lọc được ủy quyền/còn hàng, hiển thị thanh tìm kiếm, giới hạn số lượng chào bán, và nhiều hơn nữa

• styles – giao diện sáng/tối, phông chữ, và tài liệu tham chiếu đầy đủ cho các token màu tùy chỉnh

• hideColumns – kiểm soát những cột nào sẽ xuất hiện trong bảng chào bán